home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 008a / bingo21d.zip / BINGO.DOC < prev    next >
Text File  |  1991-11-15  |  185KB  |  5,656 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                        The Bingo Programmer's Text Editor
  7.                                A Shareware Product
  8.                                   Version 2.10d
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                 Reference Manual
  26.                             Copyright 1989,1990,1991
  27.                             Christopher R. S. Schanck
  28.  
  29.                                 November 15, 1991
  30.  
  31.  
  32.  
  33.  
  34.                                 Table of Contents
  35.                                 -----------------
  36.  
  37.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  38.           Philosophy . . . . . . . . . . . . . . . . . . . . . . . . .    2
  39.           The Shareware Concept and Registering  . . . . . . . . . . .    4
  40.           PsL Shareware Registration . . . . . . . . . . . . . . . . .    5
  41.           Things to Possibly Come  . . . . . . . . . . . . . . . . . .    6
  42.           Support  . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  43.           CompuServe . . . . . . . . . . . . . . . . . . . . . . . . .    8
  44.           Getting the Latest Version . . . . . . . . . . . . . . . . .    9
  45.           Using this Manual  . . . . . . . . . . . . . . . . . . . . .   10
  46.  
  47.      Critical Short Sections . . . . . . . . . . . . . . . . . . . . .   11
  48.           Installing Bingo . . . . . . . . . . . . . . . . . . . . . .   11
  49.           Invoking Bingo . . . . . . . . . . . . . . . . . . . . . . .   12
  50.           Virtual Memory & the PAGESIZE Utility  . . . . . . . . . . .   13
  51.           Impact of Virtual Memory on Performance  . . . . . . . . . .   14
  52.           Bingo and Larger Screen Displays . . . . . . . . . . . . . .   15
  53.           Bingo's Menu System  . . . . . . . . . . . . . . . . . . . .   16
  54.           Bingo's Dialogue Boxes . . . . . . . . . . . . . . . . . . .   17
  55.                String Entry Boxes  . . . . . . . . . . . . . . . . . .   17
  56.                Yes/No Boxes  . . . . . . . . . . . . . . . . . . . . .   17
  57.                Non-Editable Display Boxes  . . . . . . . . . . . . . .   17
  58.                List-Picking Boxes  . . . . . . . . . . . . . . . . . .   18
  59.           Directory Lister . . . . . . . . . . . . . . . . . . . . . .   19
  60.           Bingo and File Names . . . . . . . . . . . . . . . . . . . .   20
  61.           The Status Line  . . . . . . . . . . . . . . . . . . . . . .   21
  62.           KEYCFG: The Keyboard Configuration Program . . . . . . . . .   22
  63.                Key Names . . . . . . . . . . . . . . . . . . . . . . .   22
  64.                'open_end' Identifier . . . . . . . . . . . . . . . . .   25
  65.                'cur_file' Identifier . . . . . . . . . . . . . . . . .   26
  66.                KEYCFG Command Line Options . . . . . . . . . . . . . .   27
  67.           Bingo & The Mouse  . . . . . . . . . . . . . . . . . . . . .   28
  68.                The Mouse Cursor  . . . . . . . . . . . . . . . . . . .   28
  69.                The Mouse at the General Editing Level  . . . . . . . .   28
  70.                The Mouse and The Menus . . . . . . . . . . . . . . . .   30
  71.                The Mouse & Dialogue Boxes  . . . . . . . . . . . . . .   31
  72.                     String Entry Boxes . . . . . . . . . . . . . . . .   31
  73.                     Yes/No Boxes . . . . . . . . . . . . . . . . . . .   31
  74.                     Non-Editable Display Boxes . . . . . . . . . . . .   31
  75.                     List-Picking Boxes . . . . . . . . . . . . . . . .   31
  76.                The Mouse and The ASCII Table . . . . . . . . . . . . .   32
  77.  
  78.      Basic Editing . . . . . . . . . . . . . . . . . . . . . . . . . .   33
  79.           The Destructive Backspace  . . . . . . . . . . . . . . . . .   33
  80.           Delete EOL vs. Delete Line vs. Delete BOL  . . . . . . . . .   33
  81.           Deleting Words . . . . . . . . . . . . . . . . . . . . . . .   33
  82.  
  83.      File Handling . . . . . . . . . . . . . . . . . . . . . . . . . .   34
  84.           Edit_file & Load_file  . . . . . . . . . . . . . . . . . . .   34
  85.           Choose_file  . . . . . . . . . . . . . . . . . . . . . . . .   34
  86.           Rename_file  . . . . . . . . . . . . . . . . . . . . . . . .   34
  87.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . .   34
  88.  
  89.  
  90.  
  91.  
  92.           Quit_all . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  93.           Abort & Abort_all  . . . . . . . . . . . . . . . . . . . . .   35
  94.           Delete_file  . . . . . . . . . . . . . . . . . . . . . . . .   35
  95.           Zap_file . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  96.           Modify_save & Modify_save_all  . . . . . . . . . . . . . . .   35
  97.           Switch_file  . . . . . . . . . . . . . . . . . . . . . . . .   35
  98.           Clean_file & Clean_all . . . . . . . . . . . . . . . . . . .   35
  99.           Pick_file  . . . . . . . . . . . . . . . . . . . . . . . . .   35
  100.  
  101.      Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . .   37
  102.           Regular Expression Search & Replace Examples . . . . . . . .   37
  103.  
  104.      Navigation  . . . . . . . . . . . . . . . . . . . . . . . . . . .   40
  105.  
  106.      Block Handling  . . . . . . . . . . . . . . . . . . . . . . . . .   41
  107.           Marking  . . . . . . . . . . . . . . . . . . . . . . . . . .   41
  108.           Operations on Blocks . . . . . . . . . . . . . . . . . . . .   41
  109.           Named Buffers  . . . . . . . . . . . . . . . . . . . . . . .   42
  110.           Miscellaneous Functions  . . . . . . . . . . . . . . . . . .   42
  111.  
  112.      Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . .   43
  113.  
  114.      Extra Functions . . . . . . . . . . . . . . . . . . . . . . . . .   44
  115.           Help . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44
  116.           Info . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44
  117.           Pick & Exec  . . . . . . . . . . . . . . . . . . . . . . . .   44
  118.           Quit and Save Status . . . . . . . . . . . . . . . . . . . .   44
  119.           Global . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  120.           Ascii_table  . . . . . . . . . . . . . . . . . . . . . . . .   45
  121.           Load_ & Write_profile  . . . . . . . . . . . . . . . . . . .   45
  122.           Repeat_last  . . . . . . . . . . . . . . . . . . . . . . . .   46
  123.           Display_file . . . . . . . . . . . . . . . . . . . . . . . .   46
  124.           Box Draw Mode  . . . . . . . . . . . . . . . . . . . . . . .   46
  125.  
  126.      System Operations . . . . . . . . . . . . . . . . . . . . . . . .   47
  127.           Changing Directories . . . . . . . . . . . . . . . . . . . .   47
  128.           Simple Execution & Shelling  . . . . . . . . . . . . . . . .   47
  129.           Swap Execution & Shelling  . . . . . . . . . . . . . . . . .   47
  130.  
  131.      Macros  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   49
  132.           Macro Space  . . . . . . . . . . . . . . . . . . . . . . . .   49
  133.           Defining Macros  . . . . . . . . . . . . . . . . . . . . . .   49
  134.           Saving Macros  . . . . . . . . . . . . . . . . . . . . . . .   50
  135.           Saving the Entire Key Set  . . . . . . . . . . . . . . . . .   50
  136.           Executing a Macro File . . . . . . . . . . . . . . . . . . .   50
  137.  
  138.      Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   51
  139.           Window_split, _edit & _load  . . . . . . . . . . . . . . . .   51
  140.           Window_vertical  . . . . . . . . . . . . . . . . . . . . . .   51
  141.           Window_resize  . . . . . . . . . . . . . . . . . . . . . . .   51
  142.           Window_one & Window_zoom . . . . . . . . . . . . . . . . . .   51
  143.  
  144.      Printing  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   52
  145.  
  146.  
  147.  
  148.  
  149.      Error Parsing and Undo  . . . . . . . . . . . . . . . . . . . . .   53
  150.           How Error Parsing Works  . . . . . . . . . . . . . . . . . .   53
  151.           Error Parsing Method . . . . . . . . . . . . . . . . . . . .   53
  152.           Undo Capabilities  . . . . . . . . . . . . . . . . . . . . .   54
  153.           Manipulating the Undo Stack  . . . . . . . . . . . . . . . .   55
  154.  
  155.      Configuring Bingo . . . . . . . . . . . . . . . . . . . . . . . .   56
  156.  
  157.      Function List . . . . . . . . . . . . . . . . . . . . . . . . . .   57
  158.           General Editing  . . . . . . . . . . . . . . . . . . . . . .   57
  159.           File Handling  . . . . . . . . . . . . . . . . . . . . . . .   59
  160.           Searching  . . . . . . . . . . . . . . . . . . . . . . . . .   61
  161.           Navigation . . . . . . . . . . . . . . . . . . . . . . . . .   63
  162.           Block Handling . . . . . . . . . . . . . . . . . . . . . . .   66
  163.           Utilities  . . . . . . . . . . . . . . . . . . . . . . . . .   68
  164.           Extra Operations . . . . . . . . . . . . . . . . . . . . . .   70
  165.           System Operations  . . . . . . . . . . . . . . . . . . . . .   72
  166.           Macros . . . . . . . . . . . . . . . . . . . . . . . . . . .   73
  167.           Windows  . . . . . . . . . . . . . . . . . . . . . . . . . .   74
  168.           Printing . . . . . . . . . . . . . . . . . . . . . . . . . .   76
  169.           Error Parsing and Undo . . . . . . . . . . . . . . . . . . .   77
  170.           Configuration  . . . . . . . . . . . . . . . . . . . . . . .   78
  171.  
  172.      License Agreement . . . . . . . . . . . . . . . . . . . . . . . .   84
  173.  
  174.      Registration Form - Bingo 2.10d . . . . . . . . . . . . . . . . .   86
  175.  
  176.      The Author  . . . . . . . . . . . . . . . . . . . . . . . . . . .   88
  177.  
  178.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .   89
  179.  
  180.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   90
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                           Bingo 2.10d Reference Manual
  202.                                         4
  203.  
  204.  
  205.  
  206.  
  207.                                   Introduction
  208.                                   ------------
  209.  
  210.           This document serves as the reference manual for Bingo 2.10d. 
  211.      Bingo is a full-featured text editor at the right price.  Some of its
  212.      features include:
  213.  
  214.      -    high speed execution, with particularly fast searches, screen
  215.           handling, and file I/O
  216.      -    virtual memory for file storage; up to 240 Megabytes of file
  217.           storage possible
  218.      -    full color support
  219.      -    programmable integrated mouse support
  220.      -    support of VGA, EGA, & MCGA extended text modes
  221.      -    superb macro capability
  222.      -    large suite of utility functions: entab; detab; command repeat;
  223.           shift; etc.
  224.      -    custom define your own keyboard setup
  225.      -    complete menu system supporting most Bingo functions
  226.      -    multiple files, multiple windows: view different sections of the
  227.           same file, or different files at the same time
  228.      -    execute DOS commands, including command-line compilers within
  229.           only ~4k of overhead
  230.      -    regular expression search and replace
  231.      -    completely configurable from within itself
  232.      -    use placemarks to mark positions in files
  233.      -    user definable help file
  234.      -    extensive block operation support, include point, line and column
  235.           marking, and two different sets of block operations
  236.      -    one default block buffer, plus 26 additional named buffers
  237.      -    wordwrap, paragraph formatting, and autoindent support included
  238.           for text processing work
  239.      -    C Mode supports programming in the C programming language
  240.      -    User-defined delimiter and indentation matching
  241.      -    directory list picker
  242.      -    execute *any* Bingo function from within Bingo whether it has
  243.           been assigned to a key or not using a 'function picker'
  244.      -    interrupt Bingo at any point and exit, and when you restart Bingo
  245.           it will pick up exactly where you left off
  246.      -    print files & blocks through the serial port, parallel port, or
  247.           to a file, with or without line numbers and/or page headers.
  248.      -    set printing left margin, top margin, and lines per page
  249.      -    automatic processing of errors generated by the Borland and
  250.           Microsoft developmental tools.
  251.      -    undelete stack of deleted items
  252.      -    execute any command or macro "globally" over all files in the
  253.           ring
  254.      -    profile files allow file extension specific settings.
  255.      -    box draw mode for easy screen design
  256.      -    automated, timed backups
  257.  
  258.  
  259.                           Bingo 2.10d Reference Manual
  260.                                         1
  261.  
  262.  
  263.  
  264.  
  265.      Philosophy
  266.      ----------
  267.  
  268.           Text editors are not required for every system; at least, an
  269.      editor of Bingo's power is not.  If all you require of your editor is
  270.      that it allow you to modify batch files and such, Bingo is overkill. 
  271.      Cheap overkill, but still overkill.  However, if you use an editor
  272.      daily, as a programmer, as a consultant who hops from system to system
  273.      and likes to have his/her own tools, or in any other situation where
  274.      you need to depend on it, Bingo could very well be what you are
  275.      looking for.  Why?  In spite of its power, Bingo is very inexpensive,
  276.      and does some things no other editors do, as a look at its feature
  277.      list will convince you.
  278.           People who live with an editor daily for long stretches of time
  279.      know that choosing an editor is a near-religious experience.  Defense
  280.      of your choice develops into a kind of fanaticism.  In the Unix world,
  281.      VI/Emacs wars promise to extend into the next millennium.  It was the
  282.      fact that I could not find an editor I was truly comfortable with that
  283.      prompted me to design Bingo.  In doing so I believe I have created an
  284.      editor that should appeal to a broad base of users.  
  285.           Bingo allows a large degree of latitude when it comes to
  286.      assigning keys.  In a complementary fashion, it allows a user
  287.      specified file to be used for help.  Further, because of Bingo's
  288.      extensive and powerful menuing system, you do not need to memorize a
  289.      large number of keystrokes in order to use Bingo effectively.  This
  290.      allows you to get up and going in a minimum amount of time.
  291.           Bingo has a large degree of programmable mouse support has been
  292.      added.  I have found mouse use to be very nice when editing, and the
  293.      response has been very enthusiastic.  Version 2.10d added an
  294.      additional mouse primitive 'mouse_scroll' which, combined with the
  295.      macro capability, allows you to scroll and drag with your mouse.
  296.           Bingo is optimized for response time.  Screen response in
  297.      particular is very quick, taking full advantage of the PC's direct
  298.      video architecture.  Searches also occur at blazing speed -- a must if
  299.      you spend many hours with an editor.
  300.           Bingo is heavily configurable, all from within the editor itself. 
  301.      This "on-the-fly" ability is a lifesaver if you hop from one system to
  302.      another.
  303.           Bingo has all the standard macro and file handling abilities, but
  304.      it specifically excels at block handling.  Three types of marking, 27
  305.      buffers to use, and a huge array of functions to deal with block
  306.      operations allow you to use blocks to their fullest.
  307.           Especially designed for programmers, Bingo includes a suite of
  308.      utility functions to aid in handling program text.  Functions to shift
  309.      blocks of text left and right, to align blocks, to sort blocks, to
  310.      match delimiters, and to move by indentation are only a few of the
  311.      many handy functions included.  In version 2.10d, you can specify just
  312.      what a delimiter is, say "repeat" and "until".  Then you could sit on
  313.      a "repeat", and let Bingo find the matching "until".
  314.           With version 2.01, a powerful regular expression search and
  315.      replace method has been added.  Further, 'profile' files, which enable
  316.  
  317.                           Bingo 2.10d Reference Manual
  318.                                         2
  319.  
  320.  
  321.  
  322.  
  323.      specific text settings to be associated with files having certain
  324.      extensions, are supported.  To make this useful, each file (or buffer)
  325.      in the ring now maintains its own set of these settings.  This allows
  326.      you to have the correct settings for .DOC files show up when you load
  327.      .DOC files, the correct settings for .CPP files do likewise, and so
  328.      on.
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                           Bingo 2.10d Reference Manual
  376.                                         3
  377.  
  378.  
  379.  
  380.  
  381.      The Shareware Concept and Registering
  382.      -------------------------------------
  383.           This is just a general note as to what Bingo being Shareware
  384.      means to you, the user.  Shareware could just as easily be called
  385.      "Honorware": I depend upon you honor to mail in your payment for Bingo
  386.      if you are using it regularly.  All of the legal jargon describing
  387.      this Shareware concept is contained in the License & Registration
  388.      section of this manual.
  389.           Basically, I depend upon you to mail in your payment for Bingo
  390.      after you have taken a reasonable amount of time to try it out.  If
  391.      you use it regularly, please mail in the payment.  The number of man-
  392.      hours which went into Bingo is incredible; the registration fee is a
  393.      small price to pay. So if you use Bingo regularly, send me the
  394.      registration fee I charge for Bingo -- it's not much money for a very
  395.      sharp program.
  396.           When you register, you are entitled to a number of advantages,
  397.      depending on how you register.  If your registration is a Single
  398.      Version registration ($40), these benefits include:
  399.           1) If you request it, I will mail you a copy of the current
  400.           release of Bingo free.
  401.           2) You are entitled to support for 9 months, or until 1 month
  402.           past the release of the next version, whichever is longer.
  403.      If your registration is a Lifetime registration ($75), your benefits
  404.      are a little more extensive.  They include:
  405.           1) If you request it, I will mail you a copy of the current
  406.           release of Bingo free.
  407.           2) You are entitled to support for as long as Bingo is marketed
  408.           as a product, be it as shareware or commercial.
  409.           3) The next release will be mailed to you free of charge.
  410.           4) You will be notified of each successive release, and each will
  411.           be available to you for a mere $5.00 shipping fee.
  412.  
  413.           In addition, with version 2.01 and beyond, registered users of
  414.      any sort get to have their named emblazoned on their copy for all to
  415.      see;  this way everyone will know what honorable people they are.  And
  416.      no, a simple sector editor cannot change this name -- it has to be
  417.      done here.  The name will be shown on the initial screen which is
  418.      popped up when bingo is executed, and can also be accessed from the
  419.      'version_info' function.
  420.           Also, some registered users are asked to beta-test upcoming
  421.      versions -- a double-edged sword.  Beta testing is somewhat precarious
  422.      at times, but you do get to take a hand in forming the next version. 
  423.      Plus you get to have your complaints redressed faster than the general
  424.      public.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                           Bingo 2.10d Reference Manual
  434.                                         4
  435.  
  436.  
  437.  
  438.  
  439.      PsL Shareware Registration
  440.      --------------------------
  441.  
  442.           You can order directly from me at the below address or from
  443.      Public (software) Library with your MC, Visa, AmEx or Discover
  444.      card by calling 800-2424-PsL or 713-524-6394 or by FAX to
  445.      713-524-6398 or by CompuServe to 71355,470 or by mail to PsL, PO
  446.      Box 35705, Houston, Texas 77235-5705.  Bingo's order # is 10399.
  447.      Please use this number when ordering if possible.  These numbers
  448.      are for ordering only.  For information about dealer pricing,
  449.      volume discounts, site licensing, shipping of product, returns,
  450.      latest version number or other technical information, contact me
  451.      at
  452.  
  453.                        Christopher R. S. Schanck
  454.                        PO Box 279
  455.                        Hanover MD 21076
  456.                        (301) 730-9874
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.                           Bingo 2.10d Reference Manual
  492.                                         5
  493.  
  494.  
  495.  
  496.  
  497.      Things to Possibly Come
  498.      -----------------------
  499.           "The one major thing which still(!) looms in Bingo's future is
  500.           the ability to work with files larger than memory.  I am still
  501.           thinking of implementing a virtual memory method, but it may or
  502.           may not appear in later versions."
  503.  
  504.           This phrase, or something similar, has appeared in the
  505.      documentation of each of the previous versions of Bingo prior to 2.10. 
  506.      However, 2.10 introduced a fast, efficient virtual memory paradigm. 
  507.      Theoretically, it allows you to edit up to 256 Megabytes of file
  508.      storage -- that is a lot of files!  Practically, it means that if you
  509.      have the disk storage, you need not worry about memory constraints
  510.      again.  
  511.           Implementing virtual memory necessitated almost a complete
  512.      rewrite of Bingo.  Hence, not a lot of new functionality was
  513.      introduced in this version; I believe the total is about 20 new
  514.      functions, none of which add major functionality.  Several major
  515.      things are in the works for the future, including customizable menus,
  516.      a new window scheme, and an expanded macro language.  Further, the
  517.      regular expression subsystem is going to be completely rewritten for
  518.      the next release, much as the word functions were for this release.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.                           Bingo 2.10d Reference Manual
  550.                                         6
  551.  
  552.  
  553.  
  554.  
  555.      Support
  556.      -------
  557.  
  558.           As any of my registered users will tell you, I am committed to
  559.      supporting Bingo.  Without my users, where would I be?  Anyone,
  560.      registered or not, who calls or writes me will receive prompt and
  561.      (hopefully) useful help.  I particularly like to hear of requests;
  562.      anything you would like to see in Bingo, let me know.  One of my beta-
  563.      testers remarked that he felt like he had a personal editor --
  564.      anything he wanted was added.
  565.           I am now residing in the Baltimore area.  My current address and
  566.      phone number is:
  567.  
  568.           Christopher Schanck
  569.           PO Box 279
  570.           Hanover MD 21076
  571.           (301) 730-9874
  572.  
  573.      You are welcome to call me at the above number, but while the address
  574.      will be stable for the next several years, phone numbers do change. 
  575.      Should this number become invalid for any reason, call (215) 691-1070
  576.      (9am to 6pm, EST).  If you wish, you will be given a number where you
  577.      can currently reach me, or you can leave your name and number, and I
  578.      will return your call within 2-3 days.
  579.           PLEASE feel free to contact me.  I very much like to hear from
  580.      you!  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.                           Bingo 2.10d Reference Manual
  608.                                         7
  609.  
  610.  
  611.  
  612.  
  613.      CompuServe
  614.      ----------
  615.           Recently I became a subscriber to Compuserve.  You can contact me
  616.      there as:
  617.           70541,3614
  618.      On the Internet, that would be:
  619.           70541.3614@compuserve.com
  620.      This is the fastest, most reliable way to contact me.
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                           Bingo 2.10d Reference Manual
  666.                                         8
  667.  
  668.  
  669.  
  670.  
  671.      Getting the Latest Version
  672.      --------------------------
  673.           If you have a copy of Bingo but are not sure if it is the latest
  674.      version, the best way to find out is by calling the Computer
  675.      Connection BBS in Washington DC.  This is a very large, well-managed
  676.      BBS.  The latest version of Bingo will always be available here, and
  677.      E-Mail left for me will be answered.  The number is (202) 547-2008. 
  678.      Likewise, Bingo will always be on Compuserve, in the IBM section.
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                           Bingo 2.10d Reference Manual
  724.                                         9
  725.  
  726.  
  727.  
  728.  
  729.      Using this Manual
  730.      -----------------
  731.           This manual is broken into three parts.  The first is comprised
  732.      of small sections concerned with particular little parts of Bingo,
  733.      such as Installation and Invocation.  
  734.           The second part consists of sections on each major functionality
  735.      present in Bingo.  These individual sections are not tutorial in
  736.      orientation, but rather give necessary information needed to utilize
  737.      this functionality.  
  738.           The final section is a listing of all of the functions supported
  739.      by Bingo.
  740.           I suggest that the first time user first read the initial
  741.      sections for pertinent information, then go through the function list
  742.      *thoroughly*.  This will give you a clear idea of the capabilities of
  743.      Bingo.  Then, for clarification, go through the middle sections as
  744.      needed.
  745.           Finally, read the READ.ME file very carefully.  In some cases it
  746.      will have information this file doesn't contain, and it may describe
  747.      some things in greater detail as it is kept as a running log as I make
  748.      changes.
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                           Bingo 2.10d Reference Manual
  782.                                        10
  783.  
  784.  
  785.  
  786.  
  787.                              Critical Short Sections
  788.                              -----------------------
  789.  
  790.      Installing Bingo
  791.      ----------------
  792.           There are 3 files which are of critical importance for Bingo to
  793.      run. 
  794.           BE.EXE and BE.COM are the executables.  BE.EXE is the actual
  795.      editor executable.  BE.COM is the loader file; this allows Bingo to
  796.      swap itself in and out of memory.  Both of these files MUST, MUST,
  797.      MUST reside in the same subdirectory (Got that?).  If you dislike
  798.      typing 'be' at the DOS command, you CAN rename Bingo's executable. 
  799.      Just rename both the .EXE and the .COM to be the same filename (with
  800.      different extensions), for instance, you might shorten it to B.COM and
  801.      B.EXE (programmer's, being lazy in their typing, will no doubt do
  802.      this; I did ;-)  One point to remember, don't invoke the .EXE file
  803.      directly.  As long as you have both in the same directory, you can
  804.      type 'BE' (no extension), and the .COM file will be executed.  Or you
  805.      can execute the .COM file directly.
  806.           KEYCFG.SET is the compiled keyboard definition file.  This needs
  807.      to be in the same directory as BE.EXE/.COM, or in the current
  808.      directory.
  809.           KEYCFG.EXE is another program of importance; it is the program
  810.      used to generate a keyboard configuration.  It takes the name of a
  811.      configuration file (usually BINGO.CFG) and generates a keyset file
  812.      (usually called KEYCFG.SET).  See the section titled Configuring the
  813.      Keyboard for more information.
  814.           The help file BINGO.HLP, is an additional file which must be in
  815.      the same subdirectory as BE.EXE.  When you invoke help, Bingo will
  816.      look there for the file BINGO.HLP.  The file may contain your own
  817.      description of the current key layout, or just about anything else you
  818.      would like.  Bingo comes with a default help file.
  819.           As an example, assume the Bingo distribution files are contained
  820.      on drive A:, and you are installing Bingo on drive C:.      First,
  821.      move to drive C: and create a directory for bingo, called \bingo using
  822.      DOS's mkdir command.  Move to this subdirectory using 'cd \bingo'. 
  823.      Now copy the files from drive A: over to the proper subdirectory by
  824.      using 'copy A:*.* C:\BINGO'.
  825.           Finally, you probably want to add 'C:\BINGO' to your PATH
  826.      environment variable.
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                           Bingo 2.10d Reference Manual
  840.                                        11
  841.  
  842.  
  843.  
  844.  
  845.      Invoking Bingo
  846.      --------------
  847.           Starting Bingo is simple.  Simply type:
  848.  
  849.                be <filespec> <filespec> ...
  850.                be.com <filespec> <filespec> ...
  851.  
  852.      at the DOS prompt, and you are off.  One of several things will
  853.      happen.  If each filename you gave is discreet (i.e., no wildcards),
  854.      the files named will each be loaded, one after another.  If a filespec
  855.      matches more than one file, a directory list of matching files will
  856.      pop up which will allow you to choose a file or files.  See the
  857.      section on the Directory List for further explanation.
  858.           If no filespec is given, Bingo will ask behave as if you issued
  859.      'be *.*'.
  860.  
  861.           You may also specify the starting line and column position for
  862.      the each loaded file.  The '/pLL:CC' switch allows you to do this. 
  863.      For example:
  864.  
  865.           be test.doc test2.doc /p10:5 /p20
  866.  
  867.      would load the file TEST.DOC and move to the 10th line, 5th column. 
  868.      TEST2.DOC would begin on the 20th line.  If you do not give a column
  869.      argument, the first column will be assumed.  
  870.  
  871.           Similarly, you can use the '-x<filename>' switch to run a macro
  872.      file on startup.  For Example:
  873.  
  874.           be test.doc test2.doc /xfun1.mac
  875.  
  876.      would load both files, then execute the macro file FUN1.MAC inside the
  877.      buffer holding TEST.DOC.
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.                           Bingo 2.10d Reference Manual
  898.                                        12
  899.  
  900.  
  901.  
  902.  
  903.      Virtual Memory & the PAGESIZE Utility
  904.      -------------------------------------
  905.           In version 2.10, Bingo introduced a virtual memory paradigm to
  906.      allow programmers to edit more and larger files.  Virtual memory is a
  907.      simple, elegant, beautiful concept in the abstract; the reality, on an
  908.      MS-DOS based PC, is a very hairy beasty indeed.  Many different
  909.      methods for implementing virtual memory were examined.  The one I
  910.      settled on seems a good compromise; Bingo is still quick, and the
  911.      memory/disk swapping necessary when you are working with large files
  912.      is relatively unobtrusive.  I still edit fairly regularly on an 8088
  913.      machine, with a 65ms hard disk, and I find Bingo plenty fast enough. 
  914.      On a 386 with a fast drive (say, an 80meg IDE drive with a 32k onboard
  915.      cache), you never even realize it is swapping.
  916.           Bingo treats file storage as a set of fixed length blocks.  As
  917.      shipped, Bingo is configured for 2048 byte-sized blocks, or 2k. 
  918.      Internally, Bingo can deal with up to 16k of these blocks (buckets),
  919.      configurable from 1k to 16k.  The blocksize, bucketsize, or
  920.      *pagesize*, is configurable from 2k to 16k, in even increments (i.e,
  921.      2k, 4k, 6k, 8k, etc).  The larger the pagesize, the more blocks (or
  922.      buckets) allocated the higher the theoretical memory limit.  For
  923.      instance, a pagesize of 16k with 8k buckets gives a theoretical memory
  924.      limit of 128 Megabytes!  So why not just set the limits way up and be
  925.      done with it, you ask?
  926.           Two reasons.  First, the larger the pagesize, the harder Bingo
  927.      works to manipulate text.  On faster machines, larger pagesizes are
  928.      fine; on a 386/25 Mhz PC, a 16k pagesize is no problem at all.  On the
  929.      other hand, a 2k pagesize is fine on every machine out there, hence
  930.      the default setting.
  931.           The largeer the number of buckets allocated, the less
  932.      conventional memory Bingo has available for use.  So allocating a lot
  933.      more than you need is non-optimal use of your resources.
  934.           Second, let's be serious about this.  Seldom, if ever, will
  935.      someone really need to edit a file 200+ Megs in size.  Could happen;
  936.      that is why I coded it as I did.  But still.  Also, do the arithmetic. 
  937.      To edit a 200M file, you need roughly > 400M of disk storage; 200M for
  938.      the file itself, + 200M for the swapfile, + some odd number of bytes
  939.      for the file entries in the FAT table (grin).  Not a lot of systems
  940.      around with several hundred megs of storage hanging about.  But we
  941.      plan for the future.
  942.  
  943.           To set the pagesize, use the PAGESIZE.COM utility.  The syntax is
  944.      :
  945.           pagesize <# buckets> <page size> <.exe file>
  946.      where <# buckets> is the number of buckets (in Kilobytes) to allocate
  947.      on startup and <page size> is the size in Kilobytes (2,4,6,8,...,16)
  948.      and the filename is .EXE name to configure (i.e., BE.EXE).
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.                           Bingo 2.10d Reference Manual
  956.                                        13
  957.  
  958.  
  959.  
  960.  
  961.      Impact of Virtual Memory on Performance
  962.      ---------------------------------------
  963.           Virtual memory has had a measurable impact on Bingo's performance
  964.      in a number of areas.  Users coming from version 2.01 or earlier will
  965.      appreciate this discussion of differences.  
  966.           On the downside, general editing is, in my estimation, a touch
  967.      slower.  Searches, scrolling, block operations, etc.  On the other
  968.      hand,  the only machine I can tell the difference on is an ancient
  969.      8088; use an AT-class machine, and you can't see a difference. 
  970.      However, even on the 8088, things are by no means slow; searches and
  971.      such are still very quick.
  972.           One function in particular is much slower.  When you sort a
  973.      block, things are much, *much* slower in this version.  This is not so
  974.      much a consequence of the virtual memory per se, but of the new memory
  975.      structure.  In version 2.01 and earlier, sorting was done with a
  976.      recursive algorithm (N log N bound), and swapping lines meant swapping
  977.      pointers only.  In version 2.10, a stack-based sort is not acceptable,
  978.      because with a large file you could corrupt the stack.  So the
  979.      excellent CombSort algorithm (April 1991 BYTE) was used instead.  This
  980.      algorithm approximates N log N time, but is ultimately slower.  The
  981.      real speed killer, however, is that I can no longer simply swap
  982.      pointers.  Instead, I have to physically move the lines themselves
  983.      around.  This is slow, slow, slow, pushing the sort time way, way up. 
  984.      But I did not want to eliminate sorting entirely.  I use it too much
  985.      to give up.
  986.           On the upside, obviously, you can edit humongous files with ease,
  987.      and a virtually unlimited number of files.  This is an obvious
  988.      improvement.
  989.           The other highly visible improvement is in File I/O.  File
  990.      reading and writing has been speeded up by something approaching a
  991.      factor of 4.  The larger you set the pagesize, the faster file IO will
  992.      be.
  993.           A large number of small functions were also improved, such as
  994.      adding the 'pick_file' function and string-editing recall.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.                           Bingo 2.10d Reference Manual
  1014.                                        14
  1015.  
  1016.  
  1017.  
  1018.  
  1019.      Bingo and Larger Screen Displays
  1020.      --------------------------------
  1021.           EGA, VGA, and MCGA video display cards support displays larger
  1022.      than the standard 25 rows by 80 columns.  Bingo does support editing
  1023.      on these screen sizes.   Bingo can be set to handle screen displays in
  1024.      one of three ways:
  1025.           -    Bingo can be set to detect the current screen type and
  1026.                dimensions, and do retrace checking.
  1027.           -    Bingo can be set to detect the current screen type and size,
  1028.                but do no retrace checking.
  1029.           -    Bingo can be set to switch to 43/50 line mode if it is
  1030.                supported.  No retrace checking will be performed.
  1031.      As shipped, Bingo chooses the middle of these three courses.  The
  1032.      retrace checking is only done if you are using a color display with a
  1033.      25x80 configuration.
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                           Bingo 2.10d Reference Manual
  1072.                                        15
  1073.  
  1074.  
  1075.  
  1076.  
  1077.      Bingo's Menu System
  1078.      -------------------
  1079.           Bingo implements a comprehensive menu structure to aid you in
  1080.      utilizing Bingo's functions.  Many people, myself included, do not
  1081.      necessarily wish to spend the time to assign every function we need to
  1082.      a keyboard equivalent.  This requires a large time investment before
  1083.      you can begin using the editor.  On the other hand, it is very
  1084.      irritating when you need a particular function and cannot use it
  1085.      because you did not have the foresight to assigned it to a key
  1086.      combination.  
  1087.           Bingo's menu system was designed to handle just this situation. 
  1088.      By assigning the 'main_menu' function to a keystroke, you effectively
  1089.      have access to *every* function Bingo has.  First, greater than 75% of
  1090.      Bingo's functions are directly accessible from the menus, grouped in
  1091.      logical sets, following a logical hierarchy.  The remaining functions
  1092.      can be accessed by selecting the 'eXtras' sub-menu, then the 'Pick &
  1093.      exec' function.  This function then allows you to choose from a list
  1094.      of *all* supported functions.
  1095.           I have found that for most people, it pays to assign your most
  1096.      commonly needed functions to keystrokes, and then rely on the menu
  1097.      system for the ones which are used to a lesser degree.  The logical
  1098.      structure of the menus allows for easy access to less frequently
  1099.      needed functions.
  1100.           The menus themselves work quite easily.  A list of possibilities
  1101.      is presented.  A menubar can be moved up and down to make your choice;
  1102.      pressing Return selects the choice.  In addition, each choice has a
  1103.      highlighted character; pressing this character will automatically
  1104.      select the choice.
  1105.           In some cases you may be presented with a child menu.  Here again
  1106.      you may make a choice as before, with one additional bit of
  1107.      functionality.  If you are in a child menu, pressing the PgUp or PgDn
  1108.      keys will move you to the previous or next sibling menu, respectively. 
  1109.  
  1110.           The Print menu, as well as all of the configuration menus, is a
  1111.      multiple menu.  This means that after you have made a choice, the
  1112.      action will be executed and you will be returned to the menu at the
  1113.      same spot.  I have found that when printing and configuring, people
  1114.      usually want to do more than one task.  Menus which are multiple will
  1115.      have an asterisk ('*') printed at the bottom of the menu border.
  1116.           The Escape key always closes the current child menu.  If you are
  1117.      at the top menu, it quits the menu system entirely.  To see how your
  1118.      mouse, if you have one, interacts with the menus, see the section
  1119.      concerning Bingo and a mouse.
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.                           Bingo 2.10d Reference Manual
  1130.                                        16
  1131.  
  1132.  
  1133.  
  1134.  
  1135.      Bingo's Dialogue Boxes
  1136.      ----------------------
  1137.           Throughout Bingo, you will encounter many dialogue boxes.  There
  1138.      are four main types.  They are:
  1139.  
  1140.           String Entry Boxes:
  1141.  
  1142.           These are the boxes which ask you for string input.  The easiest
  1143.      example is when Bingo asks you for a filename.  These boxes allow you
  1144.      to enter string input in a flexible manner.  A wide variety of
  1145.      keystrokes are available to aid in this endeavor; they are:
  1146.  
  1147.                     ^F/CursRt      One Character Forward
  1148.                     ^B/CursLt      One Character Backward
  1149.                     ^A/Home        Beginning of Line
  1150.                     ^E/End         End of Line
  1151.                     ^K/CtrlEnd     Delete to Eol
  1152.                     CtrlHome       Delete to Bol
  1153.                     ^Y             Delete Line
  1154.                     Tab            Insert from Paste Buffer 
  1155.                     Insert         Toggle insert Mode
  1156.                     Alt-A          Invoke the ASCII Table
  1157.                     Up Arrow       Pops up a list of the previous 15
  1158.                                    strings entered.
  1159.                     PgUp           Pops up a list of the previous 15 
  1160.                                    filenames used.
  1161.  
  1162.           Pressing <Escape> will abort out of the string entry operation.
  1163.  
  1164.           Yes/No Boxes:
  1165.  
  1166.           These are the boxes which require a yes or no answer to a
  1167.      question.  An example of this is when you 'quit' a file and the file
  1168.      has been modified.  Bingo will ask you if you wish to save the file.
  1169.           Each time you enter a Yes/No box, one of the two options will be
  1170.      will be highlighted.  This is the default option which will be
  1171.      selected if you press <Return>.  By using the Left and Right Arrow
  1172.      keys, you can change the current selection.  Alternatively, you can
  1173.      press either the 'y' key (any case) for a yes answer, or the 'n' key
  1174.      (any case) for a no answer.
  1175.           Pressing <Escape> will abort the operation.
  1176.  
  1177.           Non-Editable Display Boxes:
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                           Bingo 2.10d Reference Manual
  1188.                                        17
  1189.  
  1190.  
  1191.  
  1192.  
  1193.           The easiest example of this type of box is the Help box, or the
  1194.      Info box.  This type of box simply displays a number of lines within a
  1195.      box.  By using the Up and Down arrows (also the space bar) you may
  1196.      scroll by lines, and by using the Page Up and Page Down keys you may
  1197.      scroll by pages.
  1198.           Any other keystroke will exit the box.
  1199.  
  1200.  
  1201.           List-Picking Boxes:
  1202.  
  1203.           The best example of this type of dialogue box occurs when the
  1204.      'directory list picker' pops up.  This type of box is very similar to
  1205.      the Non-Editable box discussed above, but the idea here is not merely
  1206.      to display information but to facilitate making a choice.  There will
  1207.      be a menubar highlighted, showing the current selection.  You may move
  1208.      this bar up and down using the arrow and page keys.  Pressing <Return>
  1209.      will selection this option.
  1210.           Additionally, the initial character of each selection may be
  1211.      highlighted.  If so, pressing the corresponding character will
  1212.      automatically select this option.
  1213.           Finally, even if the leading characters of each selection are not
  1214.      so highlighted, you may "step" through the selections by pressing
  1215.      letter keys.  The menubar will move to the next selection which starts
  1216.      with the letter pressed.  If necessary, the menubar will wrap to the
  1217.      top of the list (Bingo will beep in this case).  In the case of the
  1218.      directory picker, the leading '\' characters of directory entries will
  1219.      be ignored.
  1220.           As is the custom, the <Escape> key will abort the operation.
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.                           Bingo 2.10d Reference Manual
  1246.                                        18
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Directory Lister
  1252.      ----------------
  1253.           One of the extremely useful features of Bingo is its directory
  1254.      lister.  Often, Bingo will ask for a filename.  If the name you give
  1255.      matches more than one file, in the case of wildcards, for instance,
  1256.      the lister will appear with a list of matches and all subdirectories
  1257.      in the current directory.  There are several features embedded in this
  1258.      lister to assist you in choosing a file. 
  1259.           First, all subdirectory entries in the current directory will are
  1260.      shown at the top, with a '\' character preceding them.  Selecting any
  1261.      of these will cause the lister to change to that directory.
  1262.           Second, pressing a letter causes the Lister to move to the next
  1263.      filename whose first character matches the letter pressed.  A beep
  1264.      will sound if the search wraps around to the beginning.
  1265.           The list is sorted alphabetically by name, but subdirectory
  1266.      entries come first.  The last entry is always the New Specification
  1267.      entry, which allows you to type in a new specification, perhaps
  1268.      another drive if it is necessary. 
  1269.           You have 2 choices in the directory lister other than choosing a
  1270.      file.  The second-last option in the list, "Load All Matching Files",
  1271.      will, as you might guess, load all the files shown in the list.  It
  1272.      will not attempt to load subdirectories.  The last option, "New File
  1273.      Spec", allows you to re-choose the directory specification.
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.                           Bingo 2.10d Reference Manual
  1304.                                        19
  1305.  
  1306.  
  1307.  
  1308.  
  1309.      Bingo and File Names
  1310.      --------------------
  1311.           Many times during normal operation, Bingo will ask you for a
  1312.      filename.  Bingo potentially handles filenames slightly differently
  1313.      than plain vanilla DOS.  In particular, let's examine the difference
  1314.      between
  1315.  
  1316.           'thisfile'          &         'thisfile.'
  1317.  
  1318.           The first does not contain a period.  In this case, Bingo will do
  1319.      two things.  First, it will, for each defined default extension, check
  1320.      if the file with that extension exists.  If it does, it will use that
  1321.      filename.  Possibly, on of the default extensions is '.*'.  This would
  1322.      lead you to a directory list picker.  
  1323.           The second contains the trailing period, and so will be used as
  1324.      is.  So, in order to specify a file ignoring the default extensions,
  1325.      you must add the trailing period.
  1326.           Additionally, Bingo accepts either '/' or '\' characters as file
  1327.      delimiters.  This will make life a little easier on those of us who
  1328.      use UNIX systems regularly.  Finally, version 2.10 allows the use of
  1329.      the '..' and '.' directory primitives.
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.                           Bingo 2.10d Reference Manual
  1362.                                        20
  1363.  
  1364.  
  1365.  
  1366.  
  1367.      The Status Line
  1368.      ---------------
  1369.           On the bottom line of each window in Bingo's display is the
  1370.      status line.  This line communicates several valuable pieces of
  1371.      information.  On the left side of the line, the current line and
  1372.      column are displayed.  Next are a series of flags:
  1373.                  a     Autoindent
  1374.                   b     Box Draw Mode
  1375.                  c     C mode 
  1376.                  i     Insert mode
  1377.                  m     Matching Mode
  1378.                  r     Recording Macro
  1379.                  t     Smart Tabs
  1380.                  w     Wordwrap
  1381.                  z     Zoom mode
  1382.      For each of these flags, if the letter is capitalized, it indicates
  1383.      that the toggle is on, while a lowercase character indicates the
  1384.      option is toggled off.
  1385.           Next you will see something looking like [x/y] where 'y' is the
  1386.      number of files in the ring, and 'x' is the position of the current
  1387.      file in the ring.
  1388.           Finally, the full pathname comes.  If it is prefaced with an
  1389.      asterisk '*', it means the file has been modified.
  1390.           At the end of one of the on screen status lines, you will see
  1391.      either one or three little pyramids.  If there is a single pyramid,
  1392.      that means it is not the active window.  If there are three pyramids,
  1393.      they tell you which is the active window.  If the three pyramids are
  1394.      pointing up, the full-width window above the status line is the
  1395.      current window.  If the three pyramids point to the left, this means
  1396.      that of the two windows above the status line, the one on the left is
  1397.      the active window.  If the three pyramids point to the right, the
  1398.      window on the right is active.
  1399.           The same rules concerning the direction of the pyramids hold for
  1400.      inactive status lines, except that only one pyramid will be present.
  1401.           If this all sounds complicated, don't worry.  Open a few windows
  1402.      and move among them; it will become much clearer.
  1403.           Finally, on the right end of the current status line, a 'T' or
  1404.      'F' character will be shown.  This represent whether the last
  1405.      operation Bingo executed returned a value of True or False; i.e.,
  1406.      whether it worked.  This does not have a major impact at the moment,
  1407.      but in future versions it will.
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.                           Bingo 2.10d Reference Manual
  1420.                                        21
  1421.  
  1422.  
  1423.  
  1424.  
  1425.      KEYCFG: The Keyboard Configuration Program
  1426.      ------------------------------------------
  1427.           KEYCFG is the program used to create a keyboard configuration
  1428.      which the Bingo executable can utilize.  The supplied configuration
  1429.      files (BINGO.CFG, EMACS.CFG, possibly others) give a good example of
  1430.      how to set up the file, so this section will simply go over the high
  1431.      points again.
  1432.           KEYCFG is invoked as follows:
  1433.  
  1434.                KEYCFG <configuration name> <keyset filename>
  1435.  
  1436.      <configuration name> is the name of the text configuration source file
  1437.      you wish KEYCFG to read, and <keyset filename> is the name you wish
  1438.      KEYCFG to write the compiled keyboard setup to.  The default keyset
  1439.      file which Bingo looks for on startup is KEYCFG.SET.  Bingo will look
  1440.      first in the current directory, then in Bingo's own home directory. 
  1441.      Alternate keyset files can be loaded from within Bingo using the
  1442.      'key_set_load' function.
  1443.  
  1444.      Key Names
  1445.      ---------
  1446.      f1-f10    are the function keys
  1447.      !f1-!f10  are the shifted function keys
  1448.      @f1-@f10  are the control function keys
  1449.      #f1-#f10  are the alt function keys
  1450.      @<key>    is the control-<key> combination
  1451.      #<key>    is the alt-<key> combination
  1452.      <key>     is a simple key
  1453.  
  1454.      These are named keys:
  1455.  
  1456.           backspace                          up_arrow
  1457.           backtab                            down_arrow
  1458.           tab                                shift_insert
  1459.           escape                             shift_delete
  1460.           ctrl_backspace                     shift_home
  1461.           return                             shift_end
  1462.           ctrl_return                        shift_pgup
  1463.           alt_return                         shift_pgdn
  1464.           ctrl_tab                           shift_right_arrow
  1465.           alt_tab                            shift_left_arrow
  1466.           alt_equal                          shift_up_arrow
  1467.           alt_minus                          shift_down_arrow
  1468.           insert                             ctrl_insert
  1469.           delete                             ctrl_delete
  1470.           home                               ctrl_home
  1471.           end                                ctrl_end
  1472.           pgup                               ctrl_pgup
  1473.           pgdn                               ctrl_pgdn
  1474.           right_arrow                        ctrl_right_arrow
  1475.           left_arrow                         ctrl_left_arrow
  1476.  
  1477.                           Bingo 2.10d Reference Manual
  1478.                                        22
  1479.  
  1480.  
  1481.  
  1482.  
  1483.           ctrl_up_arrow
  1484.           ctrl_down_arrow
  1485.           keypad_plus
  1486.           keypad_minus
  1487.           keypad_divide
  1488.           keypad_aster
  1489.           keypad_return
  1490.           ctrl_keypad_plus
  1491.           ctrl_keypad_minus
  1492.           ctrl_keypad_divide
  1493.           ctrl_keypad_aster
  1494.           ctrl_keypad_return
  1495.           alt_keypad_plus
  1496.           alt_keypad_minus                   Note:  The keynames with
  1497.           alt_keypad_divide                  'grey' in them, as well as
  1498.           alt_keypad_aster                   F11, F12, and several others,
  1499.           alt_keypad_return                  denote keys which are
  1500.           grey_up_arrow                      available only if you have an
  1501.           grey_down_arrow                    extended keyboard, and you
  1502.           grey_left_arrow                    have the 'Use Extended
  1503.           grey_right_arrow                   Keyboard Bios' option turned
  1504.           grey_delete                        on.
  1505.           grey_end
  1506.           grey_home
  1507.           grey_insert
  1508.           grey_pgup
  1509.           grey_pgdn
  1510.           ctrl_grey_up_arrow
  1511.           ctrl_grey_down_arrow
  1512.           ctrl_grey_left_arrow
  1513.           ctrl_grey_right_arrow
  1514.           ctrl_grey_delete
  1515.           ctrl_grey_end
  1516.           ctrl_grey_home
  1517.           ctrl_grey_insert
  1518.           ctrl_grey_pgup
  1519.           ctrl_grey_pgdn
  1520.           alt_grey_up_arrow
  1521.           alt_grey_down_arrow
  1522.           alt_grey_left_arrow
  1523.           alt_grey_right_arrow
  1524.           alt_grey_delete
  1525.           alt_grey_end
  1526.           alt_grey_home
  1527.           alt_grey_insert
  1528.           alt_grey_pgup
  1529.           alt_grey_pgdn
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.                           Bingo 2.10d Reference Manual
  1536.                                        23
  1537.  
  1538.  
  1539.  
  1540.  
  1541.           The configuration file itself consists of lines of the format:
  1542.  
  1543.           <key specifier> <function identifier>
  1544.      or
  1545.           <key specifier> macro <macro list>
  1546.      or
  1547.           <key specifier> <character>
  1548.      or 
  1549.           ; <comment text>
  1550.  
  1551.      A line starting with a space is a continuation of the previous line.
  1552.  
  1553.           <key specifier> is either a simple <key name>, or two key names
  1554.      strung together as <key name>+<key name>.  For instance, for you
  1555.      Wordstar people, control-k q would be entered as
  1556.  
  1557.           @k+q
  1558.  
  1559.      Note: in this case, the Bingo will recognize both the sequence @k+q
  1560.      and @k+Q as the same thing -- case is not significant.
  1561.  
  1562.           The <macro list> is a list of 0 or more function descriptors, as
  1563.      listed in the Function List section, and 0 or more literal
  1564.      occurrences, and 0 or more named keys, in any order.  The literals
  1565.      must be enclosed in single quotes.  The literals will occur in the
  1566.      macro exactly as if they had been typed.  For instance, the line
  1567.  
  1568.           f1    macro 'Chris' return
  1569.  
  1570.      would define the f1 key as my name followed by a return.
  1571.  
  1572.           The <character> is any printable ASCII character, entered without
  1573.      quotes.  For instance, 
  1574.  
  1575.           <    ,
  1576.  
  1577.      would redefined the less-than symbol to be the comma.  This
  1578.      translation will occur during general editing, as well as in the
  1579.      search and replace string-entry boxes.  Everywhere else it will be
  1580.      ignored.
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.                           Bingo 2.10d Reference Manual
  1594.                                        24
  1595.  
  1596.  
  1597.  
  1598.  
  1599.           The following macro would define the Alt-C key to save all
  1600.      current modified files, execute the make command while swapping Bingo
  1601.      out to disk, saving the errors in the ERRS file, then load the ERRS
  1602.      file.
  1603.  
  1604.           #c        macro save_all swap_execute 'make > errs' return return
  1605.                     load_file 'errs.' return
  1606.  
  1607.           A more interesting variant of this is the one I used prior to
  1608.      installing the auto-error processing:
  1609.  
  1610.           #c        macro modify_save_all swap_execute 'make > errs' return
  1611.                     return window_bottom load_file 'errs.' return
  1612.  
  1613.      This version will attempt to put the errors file in the bottom-most
  1614.      window, and it will initially only save those files as have been
  1615.      modified.
  1616.           After adding  the auto-error processing, I added a more complex
  1617.      version of this macro:
  1618.  
  1619.           #c        macro modify_save_all swap_execute 'make > errs' return
  1620.                     return window_one window_split load_file 'errs.' return
  1621.                     window_previous window_resize down_arrow down_arrow
  1622.                     down_arrow down_arrow down_arrow down_arrow return
  1623.                     setup_err_parse 'errs.' return return next_error
  1624.  
  1625.      This version saves all modified files, executes MAKE as before, and
  1626.      returns.  When it returns, it makes sure there is but one window,
  1627.      splits the current window, and loads in the ERRS file.  It then
  1628.      resizes it so the bottom window is smaller, resets the error parsing
  1629.      to the ERRS file, then searches for the next (first) error.
  1630.           This last version is very sweet to use if you have a compiler
  1631.      which generates agreeable error files.  Bingo will work with most
  1632.      compilers I have come across, including the Borland and Microsoft
  1633.      compilers/assemblers.  With the Microsoft tools, you may have to tweak
  1634.      the compile flags a bit to get a usable format.
  1635.  
  1636.      'open_end' Identifier
  1637.      ---------------------
  1638.           KEYCFG allows the use of the 'open_end' identifier in macros to
  1639.      force Bingo to fetch string input from the keyboard.  For example:
  1640.  
  1641.           f1   macro search open_end 'i' return
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.                           Bingo 2.10d Reference Manual
  1652.                                        25
  1653.  
  1654.  
  1655.  
  1656.  
  1657.      will execute the search function, wait for the user to input the
  1658.      target string, then input 'i' for the search modifier and do the
  1659.      search.
  1660.           'open_end' is effective only for string input --- single key
  1661.      input situations will not respond to it.
  1662.  
  1663.      'cur_file' Identifier
  1664.      ---------------------
  1665.           KEYCFG also allows the use of the 'cur_file' identifier in macros
  1666.      to expand into the current file's name (less path) in string input. 
  1667.      For example:
  1668.  
  1669.           f1   macro load_file cur_file return
  1670.  
  1671.      will force the reload of the current file, providing it is located in
  1672.      the current directory.  NOTE:  There was a bug related to 'cur_file'
  1673.      in version 2.01; basically, if it referenced a filename longer than 11
  1674.      characters (FOOBARED.TXT), bango, you were sunk.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.                           Bingo 2.10d Reference Manual
  1710.                                        26
  1711.  
  1712.  
  1713.  
  1714.  
  1715.      KEYCFG Command Line Options
  1716.      ----------------------------
  1717.           KEYCFG recognizes three command line options.  One is a shortcut:
  1718.  
  1719.           keycfg !
  1720.  
  1721.      tells KEYCFG to assume the name of the configuration file is
  1722.      BINGO.CFG, and that the keyset file is KEYCFG.SET.  I put this in
  1723.      primarily for my own use, as I run KEYCFG often during development.
  1724.  
  1725.           'KEYCFG names' will provide an alphabetical list of all of the
  1726.      function names which are currently recognized.  Useful to have.
  1727.  
  1728.           Likewise 'KEYCFG keys' will list all recognized keynames.  Also
  1729.      useful to have.
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.                           Bingo 2.10d Reference Manual
  1768.                                        27
  1769.  
  1770.  
  1771.  
  1772.  
  1773.      Bingo & The Mouse
  1774.      -----------------
  1775.           Bingo has the capacity to make extensive use of a Microsoft
  1776.      (trademark, copyright, and kudos to Microsoft) compatible mouse,
  1777.      should you have one installed.  In order for the mouse to work, three
  1778.      things must be true. 
  1779.  
  1780.           1) It must be connected to the computer properly.  See your mouse
  1781.      manual for instructions.
  1782.           2) You must have your mouse driver installed properly.  Again,
  1783.      see your mouse manual for instructions on how to accomplish this.
  1784.           3) You must have the 'Use Mouse' option turned on, found in the
  1785.      General configuration menu. Bingo is shipped with mouse use turned on.
  1786.  
  1787.           Bingo is designed to allow users of three button mice to make
  1788.      full use of all three buttons (I have a three button mouse).  However,
  1789.      users with two button mice will only lose a little functionality when
  1790.      it comes to programming the mouse, and no functionality at all when it
  1791.      comes to dealing with the menus and dialogue boxes.
  1792.           It is generally easy to tell if the mouse is working; the status
  1793.      line will have four additional "buttons", each consisting of three
  1794.      arrows enclosed in square braces.  Also, to conserve space, the
  1795.      filename will be shown without its full path.
  1796.  
  1797.      The Mouse Cursor
  1798.      ----------------
  1799.           The mouse cursor will appear on your screen as a solid, non-
  1800.      blinking block, which changes color depending on the underlying color. 
  1801.      It should be possible to move the cursor over the entire screen.  If
  1802.      the mouse cursor is present, it means that a response with the mouse
  1803.      is possible.  If it is not visible, this means that at this point, no
  1804.      mouse response makes sense.
  1805.  
  1806.      The Mouse at the General Editing Level
  1807.      --------------------------------------
  1808.           At the general editing screen, Bingo has 20 programmable mouse
  1809.      events.   The programmable events are handled exactly as key
  1810.      assignments are handled: through KEYCFG.  These are the mouse names:
  1811.  
  1812.                              Mouse Event Identifiers
  1813.  
  1814.           Three_buttons                 Left_right_buttons
  1815.           Left_middle_buttons           Multiple_left_button
  1816.           Single_left_button            Right_middle_buttons
  1817.           Multiple_right_button         Single_right_button
  1818.           Multiple_middle_button        Single_middle_button
  1819.  
  1820.           Single_pyramids               Multiple_pyramids
  1821.           Single_up_arrow               Single_down_arrow
  1822.           Single_left_arrow             Single_right_arrow
  1823.           Multiple_up_arrow             Multiple_down_arrow
  1824.  
  1825.                           Bingo 2.10d Reference Manual
  1826.                                        28
  1827.  
  1828.  
  1829.  
  1830.  
  1831.           Multiple_left_arrow           Multiple_right_arrow
  1832.  
  1833.           The first ten are concerned simply with what happens when you
  1834.      press the corresponding button sequence.  Note that users of two-
  1835.      button devices will only be able to utilize five of these, those
  1836.      dealing with the left and right buttons.
  1837.           The second ten refer to the 5 "hot spots" on the active status
  1838.      line.  There are two for each button, one for a single click and one
  1839.      for a double click.
  1840.  
  1841.           Now that you know of these event names, what can you do with
  1842.      them?  Well, you can assign them anything you could assign a key.  In
  1843.      addition, two special functions are provided to help deal with the
  1844.      mouse:
  1845.  
  1846.           snap_to_mouse_xy:
  1847.                this function moves the cursor to the current mouse
  1848.                position.  If necessary, it will change the active window.
  1849.  
  1850.           mouse_scroll:
  1851.                this function is kind of an expanded snap_to_mouse_xy. 
  1852.                First, it moves the cursor to the mouse position.  Then, as
  1853.                long as a mouse button is held down, the screen will scroll
  1854.                in the following manner:
  1855.                     1) If you are in the upper 1/8 of the screen you will
  1856.                     scroll up.
  1857.                     2) If you are in the next 1/8 of the screen, the screen
  1858.                     will scroll up, but more slowly.
  1859.                     3) If you are in the lower 1/8 of the screen you will
  1860.                     scroll down.
  1861.                     4) If you are in the next lower 1/8 of the screen, the
  1862.                     screen will scroll down, but more slowly.
  1863.                If you are elsewhere on the screen, you simply move the
  1864.                cursor about.  This makes 'click & drag' operations
  1865.                possible.
  1866.  
  1867.  
  1868.      Combining these with other functions, quite powerful mouse events can
  1869.      be programmed.  For example:
  1870.  
  1871.      Single_left_button       snap_to_mouse_xy
  1872.      Single_right_button      macro snap_to_mouse_xy point_mark
  1873.      Multiple_left_button     macro snap_to_mouse_xy linemark
  1874.                                    mouse_scroll linemark
  1875.  
  1876.      The first simply moves the cursor, while the second moves the cursor
  1877.      and drops a point mark.  The third lets you scroll about the file,
  1878.      delineating an area to be marked.
  1879.  
  1880.           The ten "hot spots" can also be programmed as if they were keys.
  1881.        
  1882.  
  1883.                           Bingo 2.10d Reference Manual
  1884.                                        29
  1885.  
  1886.  
  1887.  
  1888.  
  1889.      Single_down_arrow        cursor_down
  1890.      Double_down_arrow        down_page
  1891.  
  1892.      Here, this has defined the down arrow button to respond with a
  1893.      cursor_down if a single click occurs on it, or a down_page if a double
  1894.      click occurs on it.  
  1895.           These "buttons" work a little differently than you might expect -
  1896.      - as long as you hold the mouse button down, the function will
  1897.      repetitively execute.  So, if you double click on the down arrow
  1898.      "button" and hold the second click down, you will see the file whiz by
  1899.      at a truly astonishing speed.  The speed with which the functions are
  1900.      repetitively executed can be governed using the 'conf_mdelay'
  1901.      function.
  1902.           These 20 events give you the user an unparalleled degree of
  1903.      control over how the mouse responds.
  1904.  
  1905.      The Mouse and The Menus
  1906.      -----------------------
  1907.           The mouse would not be very useful if it was not well integrated
  1908.      into the menu system.  Great pains have been taken to make mouse use
  1909.      easy and intuitive with respect to the menu system.  
  1910.           It is very simple.  The left mouse button selects something, and
  1911.      the right mouse button closes the current menu.  However, there are a
  1912.      few refinements.
  1913.           If the item you select with a single left click is in the
  1914.      rightmost menu, the effect is the same as if you had moved to that
  1915.      selection and hit <return>.  If the item is not the rightmost menu,
  1916.      say the it is in the Main menu and you currently have the Block menu
  1917.      open, then you will simply be moved to the selection, with the other
  1918.      menus closed for you.  However, no equivalent <return> will be
  1919.      executed. 
  1920.           If, however, you use a double left click, the selection will be
  1921.      executed regardless of where it was on the menu hierarchy.  Any extra
  1922.      open menus will be closed to bring you to the selected level.
  1923.           Likewise, a single right click will close the current menu. 
  1924.      However, a double click will close *all* open menus.
  1925.           Note that this gives you some capabilities which are not
  1926.      available from the keyboard.
  1927.           If the above sounds complicated, don't worry.  In practice, it is
  1928.      very easy.  I would suggest you restrict yourself to single clicks
  1929.      when you begin, then move to double clicks when you are sure of what a
  1930.      single click would do.  You will very quickly find that the menus are
  1931.      effortlessly intertwined with the mouse.
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.                           Bingo 2.10d Reference Manual
  1942.                                        30
  1943.  
  1944.  
  1945.  
  1946.  
  1947.      The Mouse & Dialogue Boxes
  1948.      --------------------------
  1949.           Throughout Bingo, you will encounter many dialogue boxes.  There
  1950.      are four main types, and all support mouse use where appropriate. They
  1951.      are:
  1952.  
  1953.           String Entry Boxes:
  1954.  
  1955.           These are the boxes which ask you for string input.  The easiest
  1956.      example is when Bingo asks you for a filename.  There are only a few
  1957.      mouse options in these boxes; most of the time you must enter text
  1958.      from the keyboard.
  1959.           However, there are three supported button events.  A single left
  1960.      click has the same effect as a <return>; it accepts the current
  1961.      string.  A double left click wipes out the string; it in effect is a
  1962.      Control-Y equivalent.  Finally, any right button click is the
  1963.      equivalent of an <Escape> key.
  1964.  
  1965.           Yes/No Boxes:
  1966.  
  1967.           These are the boxes which require a yes or no answer to a
  1968.      question.  The easiest example of this is in the configuration
  1969.      options, where you are asked if you wish to toggle the option.  By
  1970.      placing the mouse cursor over the [Yes] selection and pressing the
  1971.      left mouse button, you answer in the affirmative.  Likewise, placing
  1972.      the mouse cursor over the [No] selection and pressing the left button
  1973.      answers in the negative.  
  1974.           As usual, pressing the right mouse button is equivalent to the
  1975.      <Escape> key.
  1976.  
  1977.           Non-Editable Display Boxes:
  1978.  
  1979.           The easiest example of this type of box is the Help box, or the
  1980.      Info box.  If there are more lines than fit within the box, up and
  1981.      down arrow boxes will appear in the upper and lower right hand corners
  1982.      of the box.  By moving the mouse cursor to the corresponding box and
  1983.      holding a mouse button down, the display will scroll in the
  1984.      corresponding direction.
  1985.           As expected, the right button exits.
  1986.  
  1987.           List-Picking Boxes:
  1988.  
  1989.           The best example of this type of dialogue box occurs when the
  1990.      'directory list picker' pops up.  Here, as in the Non-Editable Display
  1991.      Boxes, up and down arrow boxes will appear if necessary.  Furthermore,
  1992.      moving the mouse cursor to a particular selection and pressing a
  1993.      single left key will move the menubar to that selection.
  1994.           Moving the mouse cursor to a particular selection and double left
  1995.      clicking will select that particular selection as if you had moved the
  1996.      menubar there and typed <return>.
  1997.           As always, the right button is the equivalent of typing <Escape>.
  1998.  
  1999.                           Bingo 2.10d Reference Manual
  2000.                                        31
  2001.  
  2002.  
  2003.  
  2004.  
  2005.      The Mouse and The ASCII Table
  2006.      -----------------------------
  2007.           The mouse is also tightly integrated with the ASCII table
  2008.      function, 'ascii_table'.  Here, single left clicking on a character
  2009.      moves the cursor to it (updating the display).  Double left clicking
  2010.      selects the character and adds it to the string.
  2011.           Single left clicking on the [Bspace] bar is equivalent to typing
  2012.      <backspace>; it removes one character from the string.  A double left
  2013.      click on this spot zeroes the string entirely.
  2014.           As always, clicking the right button is the equivalent of typing
  2015.      <Escape>.
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.                           Bingo 2.10d Reference Manual
  2058.                                        32
  2059.  
  2060.  
  2061.  
  2062.  
  2063.                                   Basic Editing
  2064.                                   -------------
  2065.  
  2066.           Basic editing concerns deletion and insertion of characters. 
  2067.      Bingo provides a number of ways to delete text without recourse to the
  2068.      block operation.  Five of these operations push deleted text onto the
  2069.      unkill stack -- 'del_eol', 'del_line', 'del_bol', 'del_word_lt', and
  2070.      'del_word_rt'.   
  2071.  
  2072.      The Destructive Backspace
  2073.      -------------------------
  2074.           Bingo supports three backspace deletion modes.  The first is the
  2075.      old favorite, the simple one character destructive backspace.    The
  2076.      second mode destructively deletes back to the previous tab stop,
  2077.      provided there are only spaces in the way.  If there are non-space
  2078.      characters in the way, it functions as in mode 1.
  2079.           The final mode deletes all the way to the left margin (column 1),
  2080.      provided it consists only of spaces.  Again, if there are non-space
  2081.      characters, it functions as mode 2.
  2082.  
  2083.      Delete EOL vs. Delete Line vs. Delete BOL
  2084.      -----------------------------------------
  2085.           The 'del_eol' function deletes the remainder of the line from the
  2086.      cursor position.  If you are on the end of a line, it brings the next
  2087.      line up to the current position.
  2088.           The 'del_line' simple deletes the entire current line, no
  2089.      questions asked.  
  2090.           The 'del_bol' deletes from the current position back to the
  2091.      beginning of the line.  If you are at the begging of a line, nothing
  2092.      happens.
  2093.           In all three cases, the deleted text is pushed onto the undo
  2094.      stack.
  2095.  
  2096.      Deleting Words
  2097.      --------------
  2098.           The 'del_word_lt' & 'del_word_rt' functions delete to the start
  2099.      of the next word, left or right, respectively.  What is a word?  This
  2100.      is up to you.  You can configure the string describing what delimits a
  2101.      word via the 'conf_word' function.  The deleted text is pushed onto
  2102.      the unkill stack;
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.                           Bingo 2.10d Reference Manual
  2116.                                        33
  2117.  
  2118.  
  2119.  
  2120.  
  2121.                                   File Handling
  2122.                                   -------------
  2123.  
  2124.           Bingo has extensive file handling capabilities, more than almost
  2125.      any other editor available.  Literally, there is little you could want
  2126.      to do with a file which Bingo will not let you do.  
  2127.           A couple of words are in order about the file format.  Bingo
  2128.      cares not at all if the file you are reading is delimited by carriage-
  2129.      return/linefeed pairs or just linefeed characters; Bingo will read
  2130.      both with equal aplomb.  Similarly, Bingo doesn't object to files
  2131.      ending with the EOF character (ASCII 26).  On output, the output
  2132.      format is governed by the configuration settings accessible through
  2133.      the 'conf_eof' and 'conf_lfs' functions. 
  2134.  
  2135.           Here are some of the high points in file handling with Bingo.
  2136.  
  2137.      Edit_file & Load_file
  2138.      ---------------------
  2139.           Editing a file with an 'edit_file' function may not always
  2140.      physically load the file from disk.  If the asked for name is already
  2141.      being edited, you will simply be moved to the proper buffer. 
  2142.      Conversely, loading a file with the 'load_file' function will always
  2143.      load the file from disk; if it exists in the ring currently, the in-
  2144.      memory version will be killed first.
  2145.  
  2146.      Choose_file
  2147.      -----------
  2148.           The 'choose_file' function pops up a list of the current files in
  2149.      the ring, and allows you to choose from among them.  Also, the option
  2150.      to edit a new file exists; this option is equivalent to the
  2151.      'edit_file' function.
  2152.  
  2153.      Rename_file
  2154.      -----------
  2155.           The 'rename_file' function changes nothing on the disk until you
  2156.      save the file explicitly; however, it does change the name of the in-
  2157.      memory file.
  2158.  
  2159.      Quit
  2160.      ----
  2161.           This is the usual way to exit a file.  If the file has not been
  2162.      modified, Bingo will immediately quit the file.  If the file has been
  2163.      modified, Bingo will ask you if you wish to save the file.  Remember
  2164.      that in this case, a <return> indicates a yes answer.
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.                           Bingo 2.10d Reference Manual
  2174.                                        34
  2175.  
  2176.  
  2177.  
  2178.  
  2179.      Quit_all
  2180.      --------
  2181.           This function repeatedly does a 'quit_file' on each file in the
  2182.      ring.  You can abort the operation at any time by typing <Escape> in
  2183.      response to a query.
  2184.  
  2185.      Abort & Abort_all
  2186.      -----------------
  2187.           These are very dangerous functions.  'abort' exits the file, no
  2188.      questions asked.  'abort_all' exits the program, no questions asked.
  2189.  
  2190.      Delete_file
  2191.      -----------
  2192.           This is just an easy way to delete an arbitrary file on disk.  No
  2193.      more, no less, but sometimes you do need free up disk space.
  2194.  
  2195.      Zap_file
  2196.      --------
  2197.           This allows you to wipe out the disk copy of the currently active
  2198.      file.  It does nothing to the in-memory version of the file itself.
  2199.  
  2200.      Modify_save & Modify_save_all
  2201.      -----------------------------
  2202.           These functions respectively save the current file or each file
  2203.      if and only if it has been modified.  Useful when saving files to
  2204.      compile, so that only modified files get recompiled.
  2205.  
  2206.      Switch_file
  2207.      -----------
  2208.           This function essentially performs a 'quit_file' followed by an
  2209.      'edit_file'.
  2210.  
  2211.  
  2212.      Clean_file & Clean_all
  2213.      ----------------------
  2214.           These functions allow you to reset the status of the file (or all
  2215.      the files) to unmodified.
  2216.  
  2217.      Pick_file
  2218.      ---------
  2219.           Bingo will, if asked, maintain a list of the 15 most recently
  2220.      edited files.  Based on the setting via the 'conf_name_save' function,
  2221.      the files will be saved in either the current directory or in Bingo's
  2222.      home directory.  'Pick_file' will popup a list of the 15 files, most
  2223.      recent at the top.  By selecting a file, you are invoking the
  2224.      'edit_file' function on it.
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.                           Bingo 2.10d Reference Manual
  2232.                                        35
  2233.  
  2234.  
  2235.  
  2236.  
  2237.      Backup_file & Backup_all
  2238.      ------------------------
  2239.           These functions will force a backup attempt of the current file
  2240.      ('backup_file') or each file in the ring ('backup_all').  Only files
  2241.      which have automatic backups turned on will be affected (See the
  2242.      'conf_timed_backups' function.)
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.                           Bingo 2.10d Reference Manual
  2290.                                        36
  2291.  
  2292.  
  2293.  
  2294.  
  2295.                                     Searching
  2296.                                     ---------
  2297.  
  2298.           There are two search algorithms present in Bingo.  One is very
  2299.      simple and very fast, and part of it is hand-coded in assembler for a
  2300.      bit more speed yet.  For 95% of what you want to do, it is just right.
  2301.           However, with the advent of version 2.01, a second search
  2302.      algorithm was added; a regular-expression method.  Regular expressions
  2303.      are a mathematical way to describe strings of text, and are very
  2304.      powerful.  Bingo's algorithm is reliable but not overly speedy; I
  2305.      suggest you keep this in mind when using it.
  2306.           If you are not familiar with regular expressions, I am not going
  2307.      to attempt to explain them to you here.  If, however, you have used
  2308.      them before, I will explain the notations I used in coding Bingo's
  2309.      algorithm.
  2310.           To perform a regexp search, use the 'R' modifier on you search
  2311.      (or replace).  If you use this modifier, the string will be
  2312.      interpreted as follows:
  2313.  
  2314.           -    classes, i.e. [0-9] and 'not' classes, i.e [~0-9]
  2315.           -    occurrences of once, once or none (?), one or more (+), none
  2316.      or more (*)
  2317.           -    grouping  {}
  2318.           -    ORing of {} groups |
  2319.           -    wildcard character .
  2320.           -    match begin and end of lines with ^ and $, respectively
  2321.           -    support for debugging regular expression search 
  2322.                patterns
  2323.           -    along with regular expression searches, you can specify the
  2324.                replacement in terms of the matched text.  '@n' in the
  2325.                replacement pattern places the text matching the nth group.
  2326.                '@@' matches the entire matched text. This allows you to do
  2327.                some nifty text manipulation.
  2328.  
  2329.           For some simple examples, see below.
  2330.  
  2331.           It is easy to limit the search area to a specific range by line
  2332.      marking a range of text.  Any search (or replace) which starts within
  2333.      a block will not move past the end of the block.  Basically, this
  2334.      means that no search or replace will continue past the end of a block.
  2335.           The 'C' option in the 'search' function will count the number of
  2336.      occurrences of the target string in the rest of the search area.
  2337.           The 'G'lobal option for search and replace operations starts from
  2338.      the current cursor position, not from the top of the file.
  2339.           Try the Search & Macro capability -- it is sharp.
  2340.  
  2341.      Regular Expression Search & Replace Examples
  2342.      --------------------------------------------
  2343.           Here are some examples of regular example search and replace.
  2344.  
  2345.      Search for --> [a-z]+/.
  2346.  
  2347.                           Bingo 2.10d Reference Manual
  2348.                                        37
  2349.  
  2350.  
  2351.  
  2352.  
  2353.           would match any sequence of one or more letters between 'a' and
  2354.           'z' followed by a single period.
  2355.  
  2356.      Search for --> help[a-z]+/.
  2357.           would match a sequence of 'help' followed by one or more letters
  2358.           then a single period.  It would match 'helpoooooo.' and 'helpp.'
  2359.           but not 'help.'
  2360.  
  2361.      Search for --> 19{87}|{88}
  2362.           would match '19' followed by one occurance of either '87' or
  2363.           '88'.
  2364.  
  2365.      Search for --> 19{87}*|{88}
  2366.           would match '19' followed by none or more occurances of '87' or a
  2367.           single occurance of '88'.  Thus it would match '19',
  2368.           '1987878787', or '1988'.
  2369.  
  2370.      Search for --> .
  2371.           matches any single character. (Note: /. would match a an actual
  2372.           period.)
  2373.  
  2374.      Search for --> ^[a-z]+
  2375.           matches a sequence of 1 or more letters, provided it starts a
  2376.           line.
  2377.  
  2378.      Search for --> ^[a-z]+$
  2379.           matches a sequence of 1 or more letters, provided it starts a
  2380.           line and ends a line.
  2381.  
  2382.      Search for --> ^[a-z]+/.[a-z]+
  2383.           basically matches filenames made up of alpha characters, which
  2384.           are found at the beginning of a line.
  2385.  
  2386.      Search for --> ^$
  2387.           matches a blank line.
  2388.                     
  2389.      Search for --> ^.
  2390.           matches a non-blank line.
  2391.  
  2392.      These last two allow you to do some neat stuff using
  2393.      the macro capability, i.e., apply a macro to every
  2394.      non-blank line.
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.                           Bingo 2.10d Reference Manual
  2406.                                        38
  2407.  
  2408.  
  2409.  
  2410.  
  2411.      Search for --> {[a-z]+}{/.}{[a-z]+}
  2412.      Replace with -->  @3.@1
  2413.           This will match a sequence of one or more letters, followed by a
  2414.           period, followed by one or more letters (a filename,
  2415.           essentially).  The replace will put the text matching the 3rd
  2416.           group first, then a period, then the text matching the 1st group. 
  2417.           On a filename, this will have the effect of reversing the order
  2418.           of the name and the extension, i.e:
  2419.  
  2420.                filename.txt
  2421.  
  2422.           would become
  2423.  
  2424.                txt.filename
  2425.  
  2426.           since 'filename' would match the first group and 'txt' matches
  2427.           the third group.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.                           Bingo 2.10d Reference Manual
  2464.                                        39
  2465.  
  2466.  
  2467.  
  2468.  
  2469.                                    Navigation
  2470.                                    ----------
  2471.  
  2472.           Navigation in Bingo is very straightforward.  You may move in
  2473.      terms of characters, lines, words, windowfuls, and the entire file. 
  2474.      You can also jump to the beginning and end of a marked block. 
  2475.      Finally, you can jump to a specified line, or by a relative number of
  2476.      lines, in the file using the Jump function.
  2477.           In addition, Bingo supports placemarks.  I had never really used
  2478.      placemarks much, or "bookmarks" as they are sometimes called.  But a
  2479.      buddy of mine told me to try them when in big files, and I was
  2480.      impressed.  But the editor I tried them in allowed only one; this is
  2481.      just not enough.  So I went one better.  Actually, I went 9 better.
  2482.           Bingo provides 10 placemarks.  You can drop one, jump to one, or
  2483.      pop up a list of the current placemarks.  Each placemark defines a
  2484.      file, a line, and a column.  When you try to jump to a placemark and
  2485.      the file it pertains to is not in the ring, the file will be fetched.
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.                           Bingo 2.10d Reference Manual
  2522.                                        40
  2523.  
  2524.  
  2525.  
  2526.  
  2527.                                  Block Handling
  2528.                                  --------------
  2529.  
  2530.      Marking
  2531.      -------
  2532.           Block marking is extremely flexible.  Three types of marking are
  2533.      supported.  Line marking considers lines to be the smallest
  2534.      indivisible chunks of text.  It is primarily used when editing large
  2535.      sections of program code, since much of this type of editing involves
  2536.      moving lines.
  2537.           Point marking, on the other hand, considers single characters to
  2538.      be the smallest indivisible portions of text.  this is useful for
  2539.      replicating portions of lines, rather than whole lines. 
  2540.           While Point marking "snakes" the mark from one point to the next,
  2541.      Vertical marking lets you define corners of a column-oriented block.
  2542.           As of 2.10c there are two methods of marking, governed by the
  2543.      'conf_automark' function.  If auto-marking is turned off, marking
  2544.      proceeds as follows: go to the beginning of the block you wish to
  2545.      mark; execute the appropriate mark function for the block type you are
  2546.      interested in; move to the end of the block you wish to mark; mark
  2547.      again.
  2548.           If automarking is turned on, things work differently.  Now, when
  2549.      you mark, you turn marking 'on'.  As you move about the file, the
  2550.      block will follow you until you decide to mark the end.  However, you
  2551.      do not have to mark the end of the block; Bingo will simply assume the
  2552.      current position is the other end of the block.
  2553.           You can also use the 'extend_mark' function.  This simply extends
  2554.      the current marking scheme to the current cursor position.  If there
  2555.      is no mark in the file, 'Extend_mark' will display an error message.
  2556.  
  2557.      Operations on Blocks
  2558.      --------------------
  2559.           Bingo supports two slightly different sets of block operations. 
  2560.      The first set will be familiar to users of many programming editors,
  2561.      while the second will bring back memories of any Wordstar compatible
  2562.      editor they may have used.
  2563.           The first set of operations consists of three functions: 'cut',
  2564.      'copy', 'paste'.  'cut' snips the marked region to the block buffer,
  2565.      removing it from the file.  'copy' does the same thing, but it leaves
  2566.      the marked text intact in the file.  In both cases, if nothing is
  2567.      marked and you have this option turned on, Bingo will assume you wish
  2568.      the current line to be linemarked.
  2569.           'paste' is very simple: whatever is currently in the block buffer
  2570.      is placed at the current cursor position, based on the marking method
  2571.      used.  If the contents were point marked, the contents are simply
  2572.      'squirted' into the text.  If the contents were line marked, the lines
  2573.      are inserted above the current line.
  2574.  
  2575.           There is also an alternate type of paste operation, that of
  2576.      'paste_replace'.  In this case, the paste buffer's contents overwrite
  2577.      the needed amount of space in the text, rather than squirting between
  2578.  
  2579.                           Bingo 2.10d Reference Manual
  2580.                                        41
  2581.  
  2582.  
  2583.  
  2584.  
  2585.      existing text.  This type of pasting will only work for Column and
  2586.      Line marked blocks.  Be careful! You can hurt yourself with this one.
  2587.           The second type of block operations available are similar in
  2588.      nature to those used by Wordstar-compatible editors.  Block operations
  2589.      consist of three steps: mark the text, move to the destination
  2590.      position, invoke the function.
  2591.           'block_move' moves the currently marked blocked of text to the
  2592.      current cursor position.  'block_copy' does the same thing, except it
  2593.      leaves a copy behind.
  2594.           'block_delete' is functionally identical to Cut, except that it
  2595.      requires that a block be marked; the setting of the auto linecut
  2596.      toggle has no effect on 'block_delete'.
  2597.  
  2598.      Named Buffers
  2599.      -------------
  2600.           In addition to the default paste buffer, Bingo supports 26 named
  2601.      buffers, 'a'-'z'.  In order to change which buffer is currently in
  2602.      use, use the 'name_buffer' function.  Press the letter of the buffer
  2603.      you want, or <return> for the default buffer.  Until you change the
  2604.      buffer, Bingo will use the currently named buffer for all its
  2605.      operations.  All buffers will be saved when a swapping operation is
  2606.      being done.
  2607.  
  2608.      Miscellaneous Functions
  2609.      -----------------------
  2610.           The 'buffer_info' function displays various pertinent info about
  2611.      all the paste buffers, as well as which buffer is the currently active
  2612.      one.  
  2613.           The 'look_buffer' function will display the current contents of
  2614.      the current paste buffer in a non-editable window, up to the first 100
  2615.      lies.  That should be enough to give you an idea of what is in there.
  2616.           The 'report_bsize' function reports the size of the currently
  2617.      marked block in terms of lines and characters.
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.                           Bingo 2.10d Reference Manual
  2638.                                        42
  2639.  
  2640.  
  2641.  
  2642.  
  2643.                                     Utilities
  2644.                                     ---------
  2645.  
  2646.           Bingo provides large number of utilities to be used to manipulate
  2647.      text.  Functions are available to:
  2648.  
  2649.           -    change the case of a block
  2650.           -    strip the high bit from characters in a block
  2651.           -    place tabs within text, and expand tabs within text
  2652.           -    shift blocks a certain number of spaces
  2653.           -    align lines with other lines
  2654.           -    sort blocks, in ascending or descending order, on a
  2655.                particular column
  2656.           -    fill a vertically-marked block with a specific character 
  2657.           -    format a paragraph
  2658.           -    count the number of words over a span of lines
  2659.           -    insert the current time and date into the file
  2660.  
  2661.           The big thing with the utilities is: play with them.  They allow
  2662.      you to do some really useful things to your text.  Particularly,
  2663.      entab/detab are very useful when importing files from other
  2664.      systems/editors.  You can take a file with hard tabs in it which
  2665.      assumed a tabsize of 8 characters, detab it, change the tabsize to 3,
  2666.      entab it, and save it ready for another editor which demands hard tabs
  2667.      with a tabsize of 3.
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.                           Bingo 2.10d Reference Manual
  2696.                                        43
  2697.  
  2698.  
  2699.  
  2700.  
  2701.                                  Extra Functions
  2702.                                  ---------------
  2703.  
  2704.      Help
  2705.      ----
  2706.           The 'help' function attempts to read the file BINGO.HLP located
  2707.      in the same directory as BE.EXE.  This file can consist of anything
  2708.      you wish, and contain as many lines as you wish (it must fit into
  2709.      memory...).
  2710.  
  2711.      Info
  2712.      ----
  2713.           This function simply brings up some useful info, such as the size
  2714.      each file will be when written to disk, current date and time, etc.
  2715.  
  2716.      Pick & Exec
  2717.      -----------
  2718.           This function asks for a function descriptor to execute.  The
  2719.      same function descriptors are used as are used by KEYCFG.  If you give
  2720.      it an unrecognized descriptor, a list of all supported functions are
  2721.      popped up for your convenience.  If you give it substring, such as
  2722.      'win', all functions descriptors which contain 'win' anywhere will be
  2723.      shown; in this case the window functions.  Tie this to an easy to
  2724.      remember key and all of Bingo's functions are at your fingertips.  
  2725.           This is also useful when you are trying to remember a particular
  2726.      function descriptor and you don't have the documentation handy.
  2727.  
  2728.      Quit and Save Status
  2729.      --------------------
  2730.           This simply saves the current Bingo status information, copies of
  2731.      all current files, and exits.  When you next start Bingo, it will ask
  2732.      if you wish to restore Bingo to its previous state.  If you say yes,
  2733.      you will be placed exactly where you left off.  If you indicate no,
  2734.      Bingo will proceed normally, leaving the suspension files in place to
  2735.      be dealt with the next time Bingo is invoked.
  2736.           This function is ultra-useful since it allows for easy
  2737.      interruptions when you are working.
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.                           Bingo 2.10d Reference Manual
  2754.                                        44
  2755.  
  2756.  
  2757.  
  2758.  
  2759.      Global
  2760.      ------
  2761.           This is an *extremely* powerful function.  When invoked, it asks
  2762.      for a keystroke to execute globally.  The keystroke can invoke a
  2763.      macro, or simple be tied to a function.  For each file in the ring,
  2764.      Bingo will ask if you wish the function to be executed; your options
  2765.      are the same as they are when doing a search & replace operation: 
  2766.           Y         Yes, do operation, go to next file
  2767.           N         No, don't do operation, but do go to next file
  2768.           O         Yes, do the operation, but abort the global operation
  2769.                     afterwards.
  2770.           G         Yes, do the operation, and do it for all remaining
  2771.                     files without asking.
  2772.           Q         Abort the global operation right now.
  2773.      You must be *very* careful when using this operation; any functions
  2774.      which change the number of files in the ring can be dangerous.  Be
  2775.      prudent when using it, and you will be fine, use it without some
  2776.      forethought, and you may get bitten and regret it.
  2777.           In version 2.10, this function was cleaned up a good deal; it
  2778.      should be rock-steady reliable, and much cleaner in its interface.
  2779.  
  2780.      Ascii_table
  2781.      -----------
  2782.           This function serves a dual purpose.  First, it will pop up a
  2783.      display of all 256 characters, serving as a handy reminder of the
  2784.      characters available.  As you move the cursor over the table, the
  2785.      decimal, octal, hexadecimal, and mnemonic values, if appropriate.
  2786.           Further, by moving onto a particular character and hitting
  2787.      return, you will add this character to the string displayed at the
  2788.      top.  You can build a string up to about 30 characters in length.  The
  2789.      <Backspace> key will delete the last character on the string.  When
  2790.      you press <Escape> to leave, the contents of the string will be
  2791.      inserted into the text at the current cursor position.
  2792.  
  2793.      Load_ & Write_profile
  2794.      ---------------------
  2795.           These functions allow you to manage profile files. 
  2796.      'load_profile' will load the profile file for the given extensions,
  2797.      given that it exists.
  2798.           'write_profile' will save the current text settings to the
  2799.      profile file for the named extension.  Further, you will be given the
  2800.      option of saving the file in the current directory (where Bingo looks
  2801.      first) or in Bingo's home directory (where Bingo looks second).
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.                           Bingo 2.10d Reference Manual
  2812.                                        45
  2813.  
  2814.  
  2815.  
  2816.  
  2817.      Repeat_last
  2818.      -----------
  2819.           This is a handy function.  It will execute the most-recently-
  2820.      executed function again.  It won't change what that most-recently-
  2821.      executed function was.
  2822.  
  2823.      Display_file
  2824.      ------------
  2825.           Simple, useful.  It will popup the named file into a scrollable
  2826.      window, very similar to the help file.  This would let you create
  2827.      multiple help files.
  2828.  
  2829.      Box Draw Mode
  2830.      -------------
  2831.           This is an enourmously useful capability.  When the
  2832.      'toggle_box_draw' function is executed, you will be asked whether you
  2833.      wish to use single or double line drawing.  After you make your
  2834.      choice, the 4 cursor movement functions will respond differently. 
  2835.      When you move the cursor up via the 'cursor_up' function, the cursor
  2836.      will move up, but it will trail a line (of the appropriate mode)
  2837.      behind.  Corners and intersections will be handled automatically.  The
  2838.      line characters will be placed into the text as if Bingo was in
  2839.      overwrite mode. 
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.                           Bingo 2.10d Reference Manual
  2870.                                        46
  2871.  
  2872.  
  2873.  
  2874.  
  2875.                                 System Operations
  2876.                                 -----------------
  2877.  
  2878.           Bingo supports a number of system operations.  While they are not
  2879.      large in number, they are large in utility.
  2880.  
  2881.      Changing Directories
  2882.      --------------------
  2883.           The 'chdir' function will allow you to change the currently
  2884.      logged directory, or even drive.  Not used often, but when it is
  2885.      needed, it tends to be *really* needed.
  2886.  
  2887.      Simple Execution & Shelling
  2888.      ---------------------------
  2889.           The 'exec_command' function simply executes a given DOS command
  2890.      line and returns.  It does not do anything fancy, and Bingo will
  2891.      remain in memory (consuming quite a bit of memory) but it is fast and
  2892.      simple for issuing short commands.
  2893.           The 'shell' function is identical to 'exec_command', except it
  2894.      takes no arguments.  It simply gives you a DOS shell.
  2895.  
  2896.      Swap Execution & Shelling
  2897.      -------------------------
  2898.           More often than not, particularly in the case of executing
  2899.      command-line compilers, you simply can't afford to let Bingo hang
  2900.      around in memory, since it consumes a bit.  So Bingo provides two
  2901.      other methods for executing commands.  While they appear identical in
  2902.      form and function to the previous pair of functions, 'swap_execute' &
  2903.      'swap_shell', are much more interesting.  
  2904.           While they, too, execute a command or shell to DOS, prior to
  2905.      doing so, they save all relevant information such as copies of the
  2906.      current files, etc., then swap Bingo out of memory.  When this
  2907.      happens, the ~4k kernel of BE.COM is left behind to manage things in
  2908.      Bingo's absence.  When the command is terminated, Bingo will reappear,
  2909.      load all the state info saved previously, and for all intents and
  2910.      purposes, you are right where you left off.  You can define macros
  2911.      across this gap, your placemarks stay intact, etc.  
  2912.           The cost is a small bit of speed when Bingo saves the state
  2913.      information and reads it again later, but it is negligible for the
  2914.      performance return.  It is ideal for running command-line compilers
  2915.      and other memory intensive programs from within Bingo.
  2916.           One thing to remember: the size of your paste buffers as well as
  2917.      the size of your undo stack affect the time it takes to save and
  2918.      restore Bingo's status.  Keep this in mind when you are configuring
  2919.      the stack size, and when you are utilizing multiple paste buffers.
  2920.           In versions prior to 1.1b, Bingo would not swap shell properly on
  2921.      some machines while running DOS 4.00 and higher.  This has been
  2922.      rectified.
  2923.  
  2924.  
  2925.  
  2926.  
  2927.                           Bingo 2.10d Reference Manual
  2928.                                        47
  2929.  
  2930.  
  2931.  
  2932.  
  2933.           If your machine should for some reason have to be reset while
  2934.      Bingo is swapped out (something that happens when you are developing
  2935.      software), the next time you start Bingo, it will treat the swap files
  2936.      as if they were suspension files, and restore Bingo to its previous
  2937.      state.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.                           Bingo 2.10d Reference Manual
  2986.                                        48
  2987.  
  2988.  
  2989.  
  2990.  
  2991.                                      Macros
  2992.                                      ------
  2993.  
  2994.           Bingo provides tremendous support for the creation, management,
  2995.      and execution of keyboard macros.  This level is support was indicated
  2996.      by the author's own experience in developing Bingo.  
  2997.           I started using Bingo to develop Bingo very early on in Bingo's
  2998.      life (it didn't even have a search function at the time; horrible!) in
  2999.      the hopes that this would ferret out bugs more quickly than testing
  3000.      would.  However, one of the things I missed from my previous editor
  3001.      was the ability to define and replay macros on the fly.  In addition,
  3002.      I felt my previous editor was missing some key functionality when it
  3003.      came to dealing with the keyboard, so I had the opportunity to "do
  3004.      macros right".  Of course, my definition of useful macros may differ
  3005.      from yours, but...
  3006.  
  3007.                !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3008.                !!!!                                       !!!!
  3009.                !!!! Macros from versions prior to 2.0 are !!!!
  3010.                !!!!                  not                  !!!!
  3011.                !!!! compatible with version 2.0 and above !!!!
  3012.                !!!!                                       !!!!
  3013.                !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3014.  
  3015.           As of version 2.01, Bingo retains the status of the last function
  3016.      executed internally as a True or False value; you can see this
  3017.      reflected on the far right end of the active status line.  If, during
  3018.      the execution of a macro a function returns a False value, the macro
  3019.      will terminate.  Further, if applicable, the repeat command will
  3020.      terminate.  This allows you to execute macros "until function failure"
  3021.      based on things like trying to move beyond the beginning of the line.
  3022.  
  3023.      Macro Space
  3024.      -----------
  3025.           Prior to version 2.10, Binge restricted macro space to 2048 macro
  3026.      tokens and 200 key combinations.  With version 2.10, these limits have
  3027.      been removed.  Bingo will dynamically increase its macro space to
  3028.      compensate when you add or release memory.  Thus, macro space is
  3029.      limited by available memory.
  3030.  
  3031.      Defining Macros
  3032.      ---------------
  3033.           There are three ways to define macros, all very similar.  You can
  3034.      define the scrap key to hold a macro, a single key to hold a macro, or
  3035.      a two key combination to hold a macro.  Any of these functions will
  3036.      also end a macro definition if one is currently in progress.
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.                           Bingo 2.10d Reference Manual
  3044.                                        49
  3045.  
  3046.  
  3047.  
  3048.  
  3049.           Macros can be defined across any number of activities.  Pressing
  3050.      <Escape> at any time as the response to a query from Bingo will end
  3051.      the macro presently being recorded.
  3052.  
  3053.      Saving Macros
  3054.      -------------
  3055.           Using the single key save and load functions, you can save
  3056.      favorite macros to named files for later recall.  Single saving also
  3057.      saves the key sequence the macro is attached to, and loading it in
  3058.      again will redefine the key.
  3059.  
  3060.      Saving the Entire Key Set
  3061.      -------------------------
  3062.           Bingo also allows you to save the entire key table, including all
  3063.      key assignments and all macros, for later recall.  Recalling a keyset
  3064.      file will overwrite the entire key table, so be warned.  
  3065.           When you save a keyset file, you can name the keyset file, and
  3066.      you can have it saved in Bingo's home directory or in an arbitrary
  3067.      directory.  If you name it Keycfg.set, it becomes the default file
  3068.      keyset, depending where you put it.  When Bingo starts up, it looks
  3069.      first in the current directory, then in its home directory for
  3070.      KEYCFG.SET.  This allows you to have multiple key configurations in
  3071.      different disk locations while still maintaining one executable.
  3072.  
  3073.      Executing a Macro File
  3074.      ----------------------
  3075.           You may also execute any macro which was single saved to a file
  3076.      at any time.  This executes it one, without disturbing the current key
  3077.      table assignments.  Good for macros used infrequently, but which are
  3078.      very useful.  I have a whole library of interesting ones saved at this
  3079.      point.
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.                           Bingo 2.10d Reference Manual
  3102.                                        50
  3103.  
  3104.  
  3105.  
  3106.  
  3107.                                      Windows
  3108.                                      -------
  3109.  
  3110.      Window_split, _edit & _load
  3111.      ---------------------------
  3112.            These three functions create new windows from the current
  3113.      window.  Window_split simply splits the current window into two, both
  3114.      containing the same file.
  3115.           Window_edit essentially performs a split, then executes an
  3116.      edit_file function.
  3117.           Window_load essentially performs a split, then a load_file
  3118.      function.
  3119.  
  3120.      Window_vertical
  3121.      ---------------
  3122.           Starting in version 2.0, Bingo provided the ability to split
  3123.      windows vertically.  There are some restrictions, however.  Vertical
  3124.      windows must always exist in pairs; that is, two windows sharing one
  3125.      status line.  They are even resized together.  This is not a large
  3126.      problem, but you should be aware of it.
  3127.  
  3128.      Window_resize
  3129.      -------------
  3130.           This function allows you to change the vertical size of a window,
  3131.      as well as the window below the current one.  
  3132.  
  3133.      Window_one & Window_zoom
  3134.      ------------------------
  3135.           While window_one and window_zoom superficially perform the same
  3136.      action, remember that zoom is simply a toggle, while the 'window_one'
  3137.      function eliminates all windows except the current, growing the
  3138.      current window to full size.
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.                           Bingo 2.10d Reference Manual
  3160.                                        51
  3161.  
  3162.  
  3163.  
  3164.  
  3165.                                     Printing
  3166.                                     --------
  3167.  
  3168.           Prior to version 2.01, there were two functions to print, one for
  3169.      the file and one for a marked block.  As of version 2.01, these have
  3170.      been combined into 'print_file', which prints a block if it is marked,
  3171.      otherwise it prints the file.
  3172.           There are a number of options governing printing.  You can ask
  3173.      for line numbers to be printed, page headers (time, page, filename),
  3174.      and decide whether Bingo should terminate a line with a single
  3175.      linefeed, or with linefeed/carraige return pairs.
  3176.           You can also send standalone linefeed or formfeed character, or
  3177.      send a sequence of ASCII values.
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.                           Bingo 2.10d Reference Manual
  3218.                                        52
  3219.  
  3220.  
  3221.  
  3222.  
  3223.                              Error Parsing and Undo
  3224.                              ----------------------
  3225.  
  3226.      How Error Parsing Works
  3227.      -----------------------
  3228.           Bingo provides the capability to automatically parse compiler
  3229.      generated error messages.  The procedure for this is fairly simple.
  3230.           First, you must have a text file containing the error output of
  3231.      the compiler (or assembler) in question.  This usually obtained by
  3232.      running said compiler and redirecting its output to a file.  Bring
  3233.      this file into the editor.
  3234.           Next, call the 'setup_err_parse' function, and give it the name
  3235.      of the file.  If the name matches a file in the ring, Bingo will tell
  3236.      you that error processing is setup properly.
  3237.           Now it is simple; simple call the 'next_error' or 'prev_error'
  3238.      functions.  The following things will happen:
  3239.  
  3240.           1)   Bingo will see if a next (or previous) error can be found. 
  3241.           If not, it will report that no more errors exist.
  3242.           2)   Assuming an error line is found, the filename and line
  3243.           number will be picked out of the line.  Bingo will perform and
  3244.           edit_file operation on the filename, then jump to the offending
  3245.           line.  All of this will happen within the current window.
  3246.           3)   Also, any onscreen window which contains the file being
  3247.           parsed will be updated.  The current error line will be
  3248.           highlighted automatically.
  3249.  
  3250.      As you can see, error parsing is super useful.  For a further example
  3251.      of how it works, see the example macro in the section on the KEYCFG
  3252.      program.
  3253.  
  3254.      Error Parsing Method
  3255.      --------------------
  3256.           Bingo parses error files using a "fuzzy" or "best-guess"
  3257.      algorithm.  It checks each line as follows.
  3258.           First, Bingo attempts to find a valid filename on the line.  The
  3259.      filename must contain a period, and it must have a file extension.
  3260.           After finding such a filename, Bingo verifies that the named file
  3261.      exists on disk or in the current ring.  If it does, Bingo now begins
  3262.      to look for the line number within the error file.  Bingo will look
  3263.      for the first number to follow the filename, and use this as the line
  3264.      number.
  3265.           If both a filename & a line number are found, the line will be
  3266.      recognized as a valid error/warning line. 
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.                           Bingo 2.10d Reference Manual
  3276.                                        53
  3277.  
  3278.  
  3279.  
  3280.  
  3281.           This algorithm will work for the Borland and Microsoft
  3282.      developmental tools.  However, in some cases, you may have to consult
  3283.      your manual in order to find what command-line switches have to be set
  3284.      for your compiler to output errors in a usable message format.
  3285.  
  3286.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3287.           !!!!!!!!                                !!!!!!!!!
  3288.           !!!!!!!! Note that linker errors do not !!!!!!!!!
  3289.           !!!!!!!! have line numbers, and so will !!!!!!!!!
  3290.           !!!!!!!!      not be recognized.        !!!!!!!!!
  3291.          !!!!!!!!                                 !!!!!!!!!
  3292.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3293.  
  3294.      However, whenever Bingo encounters a situation where there are no more
  3295.      errors, it will display a message saying so.  Further, it will display
  3296.      a portion of the last non-blank line in the error file on the message
  3297.      line with the "No more Errors" message, so you can verify that all
  3298.      went well.
  3299.  
  3300.      Undo Capabilities
  3301.      -----------------
  3302.           Bingo has several capabilities to allow you to recover from
  3303.      recent mistakes.  The 'Restore_line' function, will simply recall the
  3304.      state of the current line to what it was when you first arrived.  This
  3305.      is good only as long as you do not move from the line; once you leave
  3306.      the line, its original state is lost forever.
  3307.           This type of error-recovery is good for small things, but
  3308.      something more substantial was needed.  So Bingo keeps a stack of
  3309.      recently deleted items; text deleted by 'del_eol', 'del_bol', and
  3310.      'del_line' functions.  This stack is kept in reverse order; that is,
  3311.      the most recently deleted text is placed in top of the undo stack.
  3312.           Additionally, you have an option regarding text cut to the paste
  3313.      buffer.  Normally, when you place text into the paste buffer (Using
  3314.      the 'cut', 'copy', etc. functions), if the paste buffer already
  3315.      contains something, that text is discarded.  However, if you set the
  3316.      'cut to stack' option on (in the General Config Menu, or with the
  3317.      'conf_cut_stack' function), this text will be pushed onto the stack
  3318.      also.
  3319.           You can control the size of the undo stack using the
  3320.      'conf_kill_size' function (1 to 10240 lines), or through the config
  3321.      menus.  You cannot, however, turn it off.
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.                           Bingo 2.10d Reference Manual
  3334.                                        54
  3335.  
  3336.  
  3337.  
  3338.  
  3339.      Manipulating the Undo Stack
  3340.      ---------------------------
  3341.           There are three functions available to help you deal with the
  3342.      undo stack.  'rotate_kill' will popup a list of the current stack's
  3343.      contents.  By moving the menu bar and hitting return, you can move the
  3344.      selected entry to the top of the stack.
  3345.           'unkill' and 'paste_kill' are very similar.  They take the top
  3346.      member of the stack and insert it above the current line.  'unkill'
  3347.      also removes the top member from the stack.
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.                           Bingo 2.10d Reference Manual
  3392.                                        55
  3393.  
  3394.  
  3395.  
  3396.  
  3397.                                 Configuring Bingo
  3398.                                 -----------------
  3399.  
  3400.           Bingo is extremely configurable.  To access the configuration
  3401.      menu, select the 'Config' option from the main menu, or attach keys to
  3402.      particular configuration functions.  The settings themselves are
  3403.      explained explicitly in the Function List section of this document in
  3404.      the Configuration portion.  
  3405.           To make the current selections permanent, select the "Write
  3406.      setting" option found on the main configuration menu.
  3407.           There is one item of interest of interest.  There are nine
  3408.      settings which as of version 2.01 are maintained on a per buffer
  3409.      basis.  These settings are the ones saved in profile files, and are
  3410.      found on the 'Text Settings' config menu.  Each time you change these
  3411.      with a 'conf_' function, you change both the underlying default (used
  3412.      when new files are brought in) and the current buffer's settings.  For
  3413.      a few settings, there are also 'toggle_' functions, such as
  3414.      'toggle_cmode'.  These change only the current buffer's settings.
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.                           Bingo 2.10d Reference Manual
  3450.                                        56
  3451.  
  3452.  
  3453.  
  3454.  
  3455.                                   Function List
  3456.                                   -------------
  3457.  
  3458.           The following section contains a listing of the functions
  3459.      supported by Bingo, grouped by functionality.  The index at the end of
  3460.      this document makes alphabetical location of these functions simple.
  3461.  
  3462.      General Editing
  3463.      ---------------
  3464.  
  3465.      - insert_tab
  3466.           insert the number of spaces needed to move the cursor to the next
  3467.           tab stop, based on the current tabsize.
  3468.  
  3469.      - carriage
  3470.           splits the current line by moving the cursor to the start of the
  3471.           next line, taking everything to the right of the cursor along for
  3472.           the ride.  If this moves you onto the bottom line of the window,
  3473.           the line will be centered on the screen.  Depending on C mode and
  3474.           the AutoIndent mode settings, automatic indentation of some type
  3475.           may be performed.
  3476.  
  3477.      - toggle_ins
  3478.           toggles the insert/overwrite mode. Changes only the setting of
  3479.           the current buffer.
  3480.  
  3481.      - toggle_wrap
  3482.           toggles the word wrap setting. Changes only the setting of the
  3483.           current buffer.
  3484.  
  3485.      - toggle_cmode
  3486.           toggles the C mode setting, regardless of the file name. Changes
  3487.           only the setting of the current buffer.
  3488.  
  3489.      - toggle_autoindent
  3490.           toggle the autoindent setting.  Changes only the setting of the
  3491.           current buffer.
  3492.  
  3493.      - main_menu
  3494.           invokes the main menu.
  3495.  
  3496.      - del_char
  3497.           deletes the current character at the cursor position; if it was
  3498.           at the end of a line, brings the next line up.
  3499.  
  3500.      - back_space
  3501.           performs a destructive backspace, based on the current deletion
  3502.           mode in effect.
  3503.  
  3504.  
  3505.  
  3506.  
  3507.                           Bingo 2.10d Reference Manual
  3508.                                        57
  3509.  
  3510.  
  3511.  
  3512.  
  3513.      - del_line
  3514.                deletes the entire current line, regardless of position.
  3515.  
  3516.      - del_eol
  3517.                deletes all text to the end of the line; if at the end of a
  3518.                line, joins the lines.
  3519.      - del_bol
  3520.                deletes all text to beginning of line, moves to first
  3521.                column. If at the beginning, joins the line with the
  3522.                previous line.
  3523.  
  3524.      - default_del
  3525.           does one of two things depending on whether or not a block is
  3526.           marked.  If a block is marked, the 'cut' function is executed. 
  3527.           If no block is marked, the 'del_char' function is executed.
  3528.  
  3529.      - default_bspace
  3530.           similar to 'default_del', except that if no block is marked, a
  3531.           'back_space' function is executed.
  3532.  
  3533.      - del_word_rt
  3534.           deletes from the current cursor position to the start of the next
  3535.           word to the right.
  3536.  
  3537.      - del_word_lt
  3538.           deletes from the current cursor position to the start of the next
  3539.           word to the left.
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.                           Bingo 2.10d Reference Manual
  3566.                                        58
  3567.  
  3568.  
  3569.  
  3570.  
  3571.      File Handling
  3572.      -------------
  3573.  
  3574.      - edit_file
  3575.           after asking for a filename; if the file is already in the ring,
  3576.           it simply switches to it.  If it is not in the ring, it loads the
  3577.           file.
  3578.  
  3579.      - choose_file
  3580.           pops up a list of current files in the ring, and an option for a
  3581.           new file.  Selecting the New File option performs an 'edit_file'
  3582.           function.
  3583.  
  3584.      - load_file
  3585.           after asking for a filename, it loads that file from disk.  If
  3586.           the file is already in the ring, the in-memory version is first
  3587.           deleted from memory.
  3588.  
  3589.      - rename_file
  3590.           renames current file.
  3591.  
  3592.      - switch_file
  3593.           switches to a different file, performing a quit on the current
  3594.           file first.  If you escape out of the quit option, the switch
  3595.           operation will abort.
  3596.  
  3597.      - save_file
  3598.           saves the current file; does not exit.
  3599.  
  3600.      - modify_save
  3601.           saves current file ONLY if it has been modified.
  3602.  
  3603.      - quit
  3604.           exits current file.  If the file was modified, it will ask you if
  3605.           you wish to save the file; a <return> indicates yes.
  3606.  
  3607.      - abort
  3608.           exits the file, no protection, no save.
  3609.  
  3610.      - file
  3611.           saves and exits current file.
  3612.  
  3613.      - next_file
  3614.           moves to the next file in ring.
  3615.  
  3616.      - prev_file
  3617.           moves to the previous file in the ring.
  3618.  
  3619.      - quit_all
  3620.           performs a quit on each file in the ring.
  3621.  
  3622.  
  3623.                           Bingo 2.10d Reference Manual
  3624.                                        59
  3625.  
  3626.  
  3627.  
  3628.  
  3629.      - abort_all
  3630.           aborts all files, no questions asks.
  3631.  
  3632.      - file_all
  3633.           saves and exits all files.
  3634.  
  3635.      - save_all
  3636.           saves all files.
  3637.  
  3638.      - modify_save_all
  3639.           saves each modified file in the ring.
  3640.  
  3641.      - delete_file
  3642.           asks for a filename to delete on disk.
  3643.  
  3644.      - zap_file
  3645.           delete's the disk copy of the current file. 
  3646.  
  3647.      - block_load
  3648.           loads a file into the current position
  3649.  
  3650.      - clean_file
  3651.           resets the 'modified' status of the file to FALSE.
  3652.  
  3653.      - clean_all
  3654.           resets the 'modified' status of all files in the ring to FALSE.
  3655.  
  3656.      - backup_file
  3657.           forces a backup attempt for the current file; this will only have
  3658.           an effect if the file's timed backup setting is on.
  3659.  
  3660.      - backup_all
  3661.           forces a backup attempt on each file in the ring.  For each file,
  3662.           this will only have an effect if the file's timed backup setting
  3663.           is on.
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.                           Bingo 2.10d Reference Manual
  3682.                                        60
  3683.  
  3684.  
  3685.  
  3686.  
  3687.      Searching
  3688.      ---------
  3689.  
  3690.      - again
  3691.           repeat the last search operation.  If none has yet been done,
  3692.           works just like search.  If the last search operation done was a
  3693.           search & replace, only the search portion is done.
  3694.  
  3695.      - search
  3696.           search for text.  Will ask for the target text, and two
  3697.           modifiers:
  3698.                               I Ignore case
  3699.                               B Backwards
  3700.                               C Count
  3701.                               R Regexp
  3702.                               A Accent
  3703.           The 'C' option simply counts the number of occurrences.
  3704.           The 'R' option tells Bingo to interpret the input string as a
  3705.           regular expression.  See the section on searching and the READ.ME
  3706.           file for more details.
  3707.           The 'A' option tells Bingo to highlight the 'found' text until
  3708.           the next keystroke arrives.
  3709.           If the text is marked, the marking will be treated as
  3710.           linemarking, and Bingo's search will not continue past the end of
  3711.           the marked area.  This allows you to limit the searching scope to
  3712.           a particular area.
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.                           Bingo 2.10d Reference Manual
  3740.                                        61
  3741.  
  3742.  
  3743.  
  3744.  
  3745.      - replace
  3746.           search and replace text.  Will ask for target, replacement text,
  3747.           and three modifiers:
  3748.                               I Ignore Case
  3749.                               B Backwards
  3750.                               G Global Search/Replace
  3751.                               R Regexp
  3752.                               A Accent
  3753.                               P Preserve
  3754.                               D Debug
  3755.           If Global is selected, Bingo will simply replace all matching
  3756.           occurrences with the replacement text.  If not, Bingo will stop
  3757.           at each match and ask:
  3758.                               Yes:      replace and continue.
  3759.                               No:       don't replace, but continue search.
  3760.                               Only:     Replace this and stop
  3761.                               Quit:     stop, no replacement.
  3762.                               Global:   Continue with global replacement
  3763.           'R' & 'A' options work as in the search case.
  3764.           'P' tells Bingo to preserve the original cursor location and
  3765.           return to it when done with the replace operation.
  3766.           'D' is useful for regular expression work.  It tells Bingo to
  3767.           display its conception of the target string (grouping, classes,
  3768.           occurance, etc).
  3769.           Marked text limits the range as in the search function.
  3770.  
  3771.      - search_macro
  3772.           will acted like the 'search' function, but will ask for a key to
  3773.           apply when found.  It will work like the replace function, but
  3774.           instead of replacing, it will execute the given key.  
  3775.  
  3776.      - mark_last_found
  3777.           his will unmark the file and mark the last found text if you have
  3778.           not moved.
  3779.  
  3780.      - leap_forward
  3781.           searches forward for the next occurence of the next key pressed. 
  3782.           If the key is a function key or return, 'leap_forward' will use
  3783.           the previous target.
  3784.  
  3785.      - leap_backward
  3786.           searches backward for the next occurence of the next key pressed. 
  3787.           If the key is a function key or return, 'leap_backward' will use
  3788.           the previous target.
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.                           Bingo 2.10d Reference Manual
  3798.                                        62
  3799.  
  3800.  
  3801.  
  3802.  
  3803.      Navigation
  3804.      ----------
  3805.  
  3806.      - down_page
  3807.           moves down one windowful.
  3808.  
  3809.      - up_page
  3810.           moves up one windowful.
  3811.  
  3812.      - cursor_right
  3813.           moves right one char; wraps if necessary and if bounce mode is
  3814.           active.
  3815.  
  3816.      - cursor_left
  3817.           moves left one char, wraps if necessary and if bounce mode is
  3818.           active.
  3819.  
  3820.      - cursor_up
  3821.           moves up one line.
  3822.  
  3823.      - cursor_down
  3824.           moves down one line.
  3825.  
  3826.      - back_tab
  3827.           moves back to the previous tab stop.  Does not change the text at
  3828.           all.
  3829.  
  3830.      - begin_line
  3831.           goes to beginning of line.
  3832.  
  3833.      - end_line
  3834.           goes to end of line.
  3835.  
  3836.      - top_of_file
  3837.           jump to top of file.
  3838.  
  3839.      - bot_of_file
  3840.           jump to bottom of file.
  3841.  
  3842.      - next_word
  3843.           goes to beginning of next word.
  3844.  
  3845.      - prev_word
  3846.           goes to beginning of previous word.
  3847.  
  3848.      - top_of_screen
  3849.           jumps to the top of screen.
  3850.  
  3851.      - bottom_of_screen
  3852.           jumps to the bottom of screen.
  3853.  
  3854.  
  3855.                           Bingo 2.10d Reference Manual
  3856.                                        63
  3857.  
  3858.  
  3859.  
  3860.  
  3861.      - top_of_block
  3862.           jumps to the top of marked block.
  3863.  
  3864.      - bottom_of_block
  3865.           jumps to the bottom of marked block.
  3866.  
  3867.      - jump
  3868.           jump to position.  If the number is prefaced with a '+'
  3869.           character, Bingo will jump the relative distance forward.  If the
  3870.           number is prefaced with a '-' character, Bingo will jump the
  3871.           relative distance backwards.
  3872.  
  3873.      - center_line
  3874.           makes the current line the center line of the current window, and
  3875.           repaint the entire screen, all windows.  
  3876.  
  3877.      - begin_of_text
  3878.           moves the cursor to the first non-space character on the current
  3879.           line.
  3880.  
  3881.      - indent_up
  3882.           moves to previous line with same indentation scheme as current
  3883.           line.
  3884.  
  3885.      - indent_down
  3886.           moves to next line with same indentation scheme as current line.
  3887.  
  3888.      - snap_to_mouse_xy
  3889.           moves the cursor to the current mouse position, changing windows
  3890.           if necessary.
  3891.  
  3892.      - mouse_scroll
  3893.           moves the cursor to the mouse position when the mouse button is
  3894.           released;  while the button is depressed, the file will scroll up
  3895.           and down, depending on where the mouse cursor is moved.  The
  3896.           closer the cursor is to the top and bottom of the window, the
  3897.           faster the file will scroll.
  3898.  
  3899.      - place_mark
  3900.           drops a placemark, inquiring as which of the 10 allowed (0-9) you
  3901.           are concerned with.  Each placemark contains the filename, the
  3902.           line, the column.
  3903.  
  3904.      - jump_mark
  3905.           jumps to the specified placemark.  If the specified filename is
  3906.           not in the ring, Bingo will go and get it.
  3907.  
  3908.      - show_marks
  3909.           pops up a window showing the current placemarks in effect for
  3910.           this editing session.
  3911.  
  3912.  
  3913.                           Bingo 2.10d Reference Manual
  3914.                                        64
  3915.  
  3916.  
  3917.  
  3918.  
  3919.      - scroll_up
  3920.           scroll the display up one line, keeping the cursor in its same
  3921.           place.
  3922.  
  3923.      - scroll_down
  3924.           scroll the display down one line, keeping the cursor in its same
  3925.           place.
  3926.  
  3927.      - scroll_left
  3928.           scrolls the screen to left (the text to the right). 
  3929.  
  3930.      - scroll_right
  3931.           scrolls the screen to right (the txt to the left).
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.                           Bingo 2.10d Reference Manual
  3972.                                        65
  3973.  
  3974.  
  3975.  
  3976.  
  3977.      Block Handling
  3978.      --------------
  3979.  
  3980.      - line_mark
  3981.           drop a line marker.  The block will be expanded or shrunk,
  3982.           depending on the last drop made.  Line marks consider the line to
  3983.           be the smallest markable element of text.
  3984.  
  3985.      - point_mark
  3986.           drop a point marker.  The block will be expanded or shrunk,
  3987.           depending on the last drop made.  Point marks consider the
  3988.           character to be the smallest markable element of text.
  3989.  
  3990.      - vertical_mark
  3991.           drop a vertical marker. Vertical, or column, blocks are defined
  3992.           by and upper and an opposing lower corner.
  3993.  
  3994.      - extend_mark
  3995.           extends the current marked block, using whichever marking scheme
  3996.           is in place.  Does nothing if no block is marked.
  3997.  
  3998.      - unmark
  3999.           unmark all text in current buffer.
  4000.  
  4001.      - cut
  4002.           cut the marked text to the block buffer.  The marked text is
  4003.           deleted from the file.  
  4004.  
  4005.      - copy
  4006.           copy the marked text to the block buffer.  The marked text is NOT
  4007.           deleted from the file.
  4008.  
  4009.      - paste
  4010.           pastes the contents of the block buffer into the text at the
  4011.           current position.  If the contents were linemarked, the contents
  4012.           will be pasted, as lines, above the current line.  
  4013.  
  4014.      - paste_replace
  4015.           pastes the contents of the block buffer at the current location,
  4016.           overwriting the needed amount of space.  This is only valid when
  4017.           the paste buffer is Line or Vertical marked.
  4018.  
  4019.      - block_move
  4020.           moves the currently marked blocked of text to the cursor
  4021.           position.
  4022.  
  4023.      - block_copy
  4024.           copies the currently marked blocked of text to the cursor
  4025.           position.
  4026.  
  4027.  
  4028.  
  4029.                           Bingo 2.10d Reference Manual
  4030.                                        66
  4031.  
  4032.  
  4033.  
  4034.  
  4035.      - block_delete
  4036.           deletes the currently marked block of text to the block buffer;
  4037.           identical to cut.
  4038.  
  4039.      - block_save
  4040.           writes the currently marked text to a file.
  4041.  
  4042.      - swap_buf_and_block
  4043.           takes the currently marked portion, and swaps it with the current
  4044.           contents of the paste buffer.  The two blocks need not be of the
  4045.           same type.
  4046.  
  4047.      - report_bsize
  4048.           reports the number of lines and characters (line breaks in point
  4049.           marked blocks count as one character) the currently marked block
  4050.           spans.
  4051.  
  4052.      - name_buffer
  4053.           allows you to change the current paste buffer.  <return>
  4054.           specifies the default buffer, and 'a'-'z' specify their
  4055.           respective buffers.
  4056.  
  4057.      - buffer_info
  4058.           displays various pertinent information about all the paste
  4059.           buffers.
  4060.  
  4061.      - look_buffer
  4062.           displays the contents of the current buffer in a non-editable
  4063.           window.  This only displays up to the first 100 lines in the
  4064.           buffer.
  4065.  
  4066.      - cut_append
  4067.           works exactly like 'Cut', except it appends the marked text to
  4068.           the current contents of the buffer.  The text in the buffer and
  4069.           the marked text must be of the same type.
  4070.  
  4071.      - copy_append
  4072.           just as 'Cut_append', but performs a copy instead.
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.                           Bingo 2.10d Reference Manual
  4088.                                        67
  4089.  
  4090.  
  4091.  
  4092.  
  4093.      Utilities
  4094.      ---------
  4095.  
  4096.      - entab
  4097.           compresses the linemarked region specified or the entire file by
  4098.           converting spaces to tabs.
  4099.  
  4100.      - indent_tab
  4101.           compresses the leading spaces of the linemark region specified or
  4102.           the entire file by converting into the proper tabs.  Rounds to
  4103.           the nearest tab stop, thus "normalizing" the indention to tab
  4104.           stops.
  4105.  
  4106.      - detab
  4107.           expands the linemarked region specified or the entire file by
  4108.           converting tabs to spaces.
  4109.  
  4110.      - shift_block
  4111.           shifts the specified linemarked region the number of columns
  4112.           specified.  Positive numbers indicate right-shifting, negative
  4113.           numbers, left-shifting.  The character 't' is used to signify tab
  4114.           widths '-3t' shifts the block left 3 tabwidths.
  4115.  
  4116.      - lcase_block
  4117.           lowercases the linemarked region.
  4118.  
  4119.      - ucase_block
  4120.           uppercases the linemarked region.
  4121.  
  4122.      - fcase_block
  4123.           flips the case of the linemarked region.
  4124.  
  4125.      - word_count
  4126.           counts the words in the linemarked region, default the whole
  4127.           file.  A word here is defined as non-whitespace and non-
  4128.           punctuation characters, NOT by the settings of the 'conf_word'
  4129.           function.
  4130.  
  4131.      - strip_highbit
  4132.           strips the 8th bit in the linemarked region, default the whole
  4133.           file.
  4134.  
  4135.      - sort_block
  4136.           sorts block, ascending or descending, on a certain column.
  4137.  
  4138.      - reform_para
  4139.           reformats a block of text to conform to the right margin; a
  4140.           paragraph is defined as text between blank lines.  The total
  4141.           amount of text contained in a single paragraph cannot be larger
  4142.           than 30000 characters.
  4143.  
  4144.  
  4145.                           Bingo 2.10d Reference Manual
  4146.                                        68
  4147.  
  4148.  
  4149.  
  4150.  
  4151.      - repeat
  4152.           repeats a keystroke n times.  If n is '*', the function repeats
  4153.           until a search fails.  The function halts repetition on a search
  4154.           failure.
  4155.  
  4156.      - dup_line
  4157.           duplicates the current line and increments cursor to the next
  4158.           line.
  4159.  
  4160.      - align
  4161.           slides the linemarked region left or right to match indentation
  4162.           with the line immediately above the first marked line.  If not
  4163.           lines are marked, the current line is aligned.
  4164.  
  4165.      - match_delim
  4166.           finds the proper match for a delimiter.  Delimiters include
  4167.           'begin'/'end' to help Pascal programmers, as well as '({[<'.
  4168.  
  4169.      - time_stamp
  4170.           inserts the current date and time into the text.
  4171.  
  4172.      - fill_block
  4173.           fills a vertically marked block with a specified character.
  4174.  
  4175.      - center_text
  4176.           centers the current non-space text of the current line (or
  4177.           linemarked block) on its line, relative to the right margin.
  4178.  
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.                           Bingo 2.10d Reference Manual
  4204.                                        69
  4205.  
  4206.  
  4207.  
  4208.  
  4209.      Extra Operations
  4210.      ----------------
  4211.  
  4212.      - help
  4213.           views the help file BINGO.HLP.  This file must be located in the
  4214.           same directory as BE.EXE.
  4215.  
  4216.      - info
  4217.           pops up an info window, providing information on current files in
  4218.           the ring, and about Bingo's current condition
  4219.  
  4220.      - pick_exec
  4221.           this allows you to pick a function descriptor and have it
  4222.           executed.
  4223.  
  4224.      - quit_and_save_status
  4225.           his function saves the current status of Bingo as well as the
  4226.           current files, so that the next time Bingo is invoked, you will
  4227.           be given the option to pick up where you left off.
  4228.  
  4229.      - global
  4230.           this allows you to execute any keystroke globally, throughout all
  4231.           the files in the ring.  
  4232.  
  4233.      - query_quote
  4234.           inserts an integer or sequence of integers as its raw ASCII
  4235.           character.  The decimal values must be comma delimited.
  4236.  
  4237.      - ascii_table
  4238.           pops up a display of all Ascii characters.  By hitting Return on
  4239.           a character, you add it to the string.  When you hit Escape, the
  4240.           string is inserted into the text. 
  4241.  
  4242.      - toggle_display
  4243.           toggles the display size between 25 lines and 43/50 lines.  Will
  4244.           in all likelihood screw up the cursor shape, since the scan line
  4245.           counts will change.
  4246.  
  4247.      - load_profile
  4248.           loads the profile file of your choice, searching first the
  4249.           current directory then Bingo's home directory.  Prompts to see if
  4250.           you wish to load a keyset file.
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.                           Bingo 2.10d Reference Manual
  4262.                                        70
  4263.  
  4264.  
  4265.  
  4266.  
  4267.      - write_profile
  4268.           saves the text settings of the active buffer to the profile file
  4269.           of your choice in either the current directory or Bingo's home
  4270.           directory.  Settings include:
  4271.  
  4272.                          &ins=1     (insert mode, 1=yes, 0=no)
  4273.                          &tabs=5    (tabsize)
  4274.                          &wrap=1    (wordwrap, 1=yes, 0=no)
  4275.                          &indent=1  (autoindention mode, 1=yes, 0=no)
  4276.                          &cmode=0   (C mode, 0=off, 1=mode 1, etc)
  4277.                          &rmarg=65  (right margin)
  4278.                          &smart=0   (smart tabs, 1=yes, 0=no)
  4279.                          &match=0   (matching mode, 1=yes, 0=no)
  4280.                          &bspace=0  (backspace mode)
  4281.                          &timed=256 (timed backups, range 0 - 32000)
  4282.       
  4283.      - version_info
  4284.           displays various version information and the name of the person
  4285.           this copy was registered to, if it is a registered copy.
  4286.  
  4287.      - repeat_last
  4288.           repeats the last function executed.  
  4289.  
  4290.      - display_file
  4291.           will popup the named file into a scrollable box, similar to the
  4292.           help file.
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.                           Bingo 2.10d Reference Manual
  4320.                                        71
  4321.  
  4322.  
  4323.  
  4324.  
  4325.      System Operations
  4326.      -----------------
  4327.  
  4328.      - chdir
  4329.           change the currently logged directory.
  4330.  
  4331.      - exec_command
  4332.           execute a DOS command, while leaving Bingo completely resident in
  4333.           memory.
  4334.  
  4335.      - shell
  4336.           shell to DOS, leaving Bingo completely resident in memory.
  4337.  
  4338.      - swap_execute
  4339.           execute a DOS command while swapping Bingo out.  This will cause
  4340.           Bingo to save copies of the buffers as well as state information,
  4341.           and leave behind an ~10k kernel.
  4342.  
  4343.      - swap_shell
  4344.           shell to DOS while swapping as above.
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.                           Bingo 2.10d Reference Manual
  4378.                                        72
  4379.  
  4380.  
  4381.  
  4382.  
  4383.      Macros
  4384.      ------
  4385.  
  4386.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  4387.           !!!!!                                         !!!!!
  4388.           !!!!! All of these functions will end a macro !!!!!
  4389.           !!!!!        being currently defined          !!!!!
  4390.           !!!!!                                         !!!!!
  4391.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  4392.  
  4393.      - define_scrap
  4394.           start scrap macro definition.  
  4395.  
  4396.      - onekey_def
  4397.           start single-key macro definition.
  4398.  
  4399.      - twokey_def
  4400.           start two-key macro definition.
  4401.  
  4402.      - scrap
  4403.           execute the scrap macro.
  4404.  
  4405.      - single_key_save
  4406.           save a single macro to a file for later recall.  Saves the key it
  4407.           is attached to also.
  4408.  
  4409.      - single_key_load
  4410.           load a single macro from a file.  Overwrites the current
  4411.           definition for the key, if it has one.
  4412.  
  4413.      - key_set_save
  4414.           saves entire keyset, including macros, but not the scrap.
  4415.  
  4416.      - key_set_load
  4417.           load entire keyset.
  4418.  
  4419.      - run_macro_file
  4420.           runs a macro from a file saved with single_key_save.
  4421.  
  4422.      - undefine_key
  4423.           undefines a key.
  4424.  
  4425.      - end_macro
  4426.           ends the recording of a current macro.  Mostly useless, but it
  4427.           made for a useful menu entry.
  4428.  
  4429.      - key_set_impress
  4430.           THIS FUNCTION HAS BEEN DELETED AS OF VERSION 2.10.
  4431.  
  4432.  
  4433.  
  4434.  
  4435.                           Bingo 2.10d Reference Manual
  4436.                                        73
  4437.  
  4438.  
  4439.  
  4440.  
  4441.      Windows
  4442.      -------
  4443.  
  4444.      - window_edit
  4445.           this function ask for a filename, then splits the window and
  4446.           essentially performs and edit_file function for the requested
  4447.           filename.
  4448.  
  4449.      - window_load
  4450.           works like window_edit, except it forces a reload of the named
  4451.           file.
  4452.  
  4453.      - window_split
  4454.           this simply splits the current window in two and uses the current
  4455.           file for both.
  4456.  
  4457.      - window_vertical
  4458.           splits the current window vertically.  Windows can only be split
  4459.           so once.
  4460.  
  4461.      - window_close
  4462.           closes the current window and expands the above window to use its
  4463.           space.
  4464.  
  4465.      - window_zoom
  4466.           toggles the display between zoomed mode.  When the display is
  4467.           zoomed, the current window takes up the entire display, but Bingo
  4468.           'remembers' the rest of the windows and will restore them when
  4469.           zoom mode is toggled again.
  4470.  
  4471.      - window_one
  4472.           this function makes the current window the only window, wiping
  4473.           out all other windows.
  4474.  
  4475.      - window_next
  4476.           this moves to the next window down, or wraps to the top window if
  4477.           necessary.
  4478.  
  4479.      - window_previous
  4480.           this moves to the next window up, or wraps to the bottom if
  4481.           necessary.
  4482.  
  4483.      - window_top
  4484.           jumps to the topmost, leftmost window.
  4485.  
  4486.      - window_bottom
  4487.           jumps to the bottom-most, rightmost window.
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.                           Bingo 2.10d Reference Manual
  4494.                                        74
  4495.  
  4496.  
  4497.  
  4498.  
  4499.      - window_resize
  4500.           this allows you to resize the current window (and its left or
  4501.           right sibling, if it exists) and the window below (and *its* left
  4502.           or right sibling, if it exists) by 'rubberbanding' the current
  4503.           status line up and down.
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.                           Bingo 2.10d Reference Manual
  4552.                                        75
  4553.  
  4554.  
  4555.  
  4556.  
  4557.      Printing
  4558.      --------
  4559.  
  4560.      - print_file
  4561.           print the current file, or a marked block if there is one, using
  4562.           the current printer settings, to the current destination. 
  4563.           Whenever Bingo encounters a formfeed character, it will assume
  4564.           that is the start of a new page, and start the remainder of the
  4565.           line at the left margin.
  4566.  
  4567.      - send_lf
  4568.           send a line feed character to the destination.
  4569.  
  4570.      - send_ff
  4571.           send a formfeed character to the destination
  4572.  
  4573.      - send_sequence
  4574.           send a sequence of character values to the printer; e.g.
  4575.                          12,12,12,12,12
  4576.           sends a series of 5 ASCII 12's (decimal) to the destination
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.                           Bingo 2.10d Reference Manual
  4610.                                        76
  4611.  
  4612.  
  4613.  
  4614.  
  4615.      Error Parsing and Undo
  4616.      ----------------------
  4617.  
  4618.      - setup_err_parse
  4619.           this function will prompt you for a filename.  Bingo will from
  4620.           then on use the named file as the error file.  This must be
  4621.           called before next_error, prev_error, or last_error are called.
  4622.  
  4623.      - next_error
  4624.           moves, within the current window, to the next error as found in
  4625.           the current error file.  If no more errors can be found, Bingo
  4626.           will say so, and display the last non-blank line in the error
  4627.           file.  Otherwise, Bingo will edit the appropriate file into the
  4628.           current window, as well as highlighting the line in the error
  4629.           file being referenced.
  4630.  
  4631.      - prev_error
  4632.           same as error except it moves backward through the error file.
  4633.  
  4634.      - last_error
  4635.           redisplays the last error message, if there was one.
  4636.  
  4637.      - rotate_kill
  4638.           pops up the current kill stack and allows you to arbitrarily move
  4639.           a line of text to the top of the stack.
  4640.  
  4641.      - unkill
  4642.           inserts the top member of the stack above the current line. 
  4643.           Removes the top member from the stack.
  4644.  
  4645.      - paste_kill
  4646.           inserts the top member of the stack above the current line. 
  4647.           Leaves the stack alone.
  4648.  
  4649.      - restore_line
  4650.           restores the current line to its former form.
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.                           Bingo 2.10d Reference Manual
  4668.                                        77
  4669.  
  4670.  
  4671.  
  4672.  
  4673.      Configuration
  4674.      -------------
  4675.  
  4676.      - save_settings
  4677.           saves the current config settings to the image of BE.EXE on disk.
  4678.  
  4679.      - conf_color
  4680.           configure the color settings.  You select the color you are
  4681.           interested in by pressing the appropriate color.  Then, by
  4682.           watching the bottom line on the screen and pressing the up and
  4683.           down arrow keys for the foreground and the pageup and pagedown
  4684.           keys for the background, you select the color you want.  Pressing
  4685.           return will select the color.  For the overscan (border)
  4686.           attribute, only the background attribute matters.
  4687.  
  4688.      - conf_lfs
  4689.           alter the lfs-only setting.  If on, this setting has Bingo write
  4690.           files with lines separated by LF's only, in the UNIX fashion. 
  4691.           Otherwise, Bingo uses CR-LF pairs to delimit lines.
  4692.  
  4693.      - conf_backups
  4694.           allows you to specify the extensions Bingo uses to automatically
  4695.           create backup files.  If no extension is given, no backups are
  4696.           created.
  4697.  
  4698.      - conf_eof
  4699.           alter whether Bingo writes a EOF character at the end of files
  4700.           (^Z).
  4701.  
  4702.      - conf_tabexpand
  4703.           THIS FUNCTION HAS BEEN DELETED AS OF VERSION 2.10.
  4704.  
  4705.      - conf_search
  4706.           allows you to predetermine which flags (I/G/B/etc...) will be set
  4707.           initially for a search and replace attempts.
  4708.  
  4709.      - conf_stripping
  4710.           onfigure whether Bingo strips the high bit of characters when
  4711.           reading.  Only really useful when reading Wordstar files.
  4712.  
  4713.      - conf_rmargin
  4714.           set the right margin.  Affects paragraph reformatting and word
  4715.           wrap.  This changes the current buffer's setting and the global
  4716.           setting.
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.                           Bingo 2.10d Reference Manual
  4726.                                        78
  4727.  
  4728.  
  4729.  
  4730.  
  4731.      - conf_autoindent
  4732.           set whether Bingo uses autoindent mode.  Affects paragraph
  4733.           reformatting and word wrap.  This changes both the current
  4734.           buffer's setting and the global setting.
  4735.  
  4736.      - conf_wordwrap
  4737.           set the word wrap mode.  This changes both the current buffer's
  4738.           setting and the global setting.
  4739.  
  4740.      - conf_insert
  4741.           whether Bingo is in insert/overwrite mode.  This changes both the
  4742.           current buffer's setting and the global setting.
  4743.  
  4744.      - conf_tabsize
  4745.           set the tabsize.  This changes both the current buffer's setting
  4746.           and the global setting.
  4747.  
  4748.      - conf_backspace
  4749.           configure the backspace mode
  4750.                          1. Delete single chars
  4751.                          2. Delete spaces back to tab setting
  4752.                          3. Delete spaces to left margin
  4753.           This changes both the current buffer's setting and the global
  4754.           setting.
  4755.  
  4756.      - conf_macro_death
  4757.           set whether a keystroke interrupts macros.  If on, this will slow
  4758.           things down a bit, but can prevent runaway macros.
  4759.  
  4760.      - conf_cmode
  4761.           configure whether Bingo uses C Mode on *.c and *.h files.  Allows
  4762.           you to choose between two different modes of C indention:
  4763.  
  4764.                     for(i=0;i<10;i++){   and    for(i=0;i<10;i++)
  4765.                          ...stuff...            {
  4766.                     }                                ...stuff...
  4767.                                                 }
  4768.           This changes both the current buffer's setting and the global
  4769.           setting.
  4770.  
  4771.      - conf_sound
  4772.           allows you to set the frequency of the beep Bingo uses.  Setting
  4773.           it to zero will effectively turn off the sound.
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.                           Bingo 2.10d Reference Manual
  4784.                                        79
  4785.  
  4786.  
  4787.  
  4788.  
  4789.      - conf_mdelay
  4790.           allows you to specify the timing delay between repetitions of a
  4791.           function(s) being executed while a mouse button is held down. 
  4792.           For example, on reasonably quick machines, paging down while
  4793.           holding the mouse button down on one of the status line
  4794.           "hotspots" occurred so fast with version 2.0 so as to be useless. 
  4795.  
  4796.  
  4797.      - conf_button_wait
  4798.           allows you to configure, in milliseconds, the amount of delay
  4799.           Bingo will wait for the second click of a double click.
  4800.      - conf_shadow
  4801.           silly function, configures whether Bingo uses "shadow" boxes. 
  4802.           Play with it, amaze your friends.
  4803.  
  4804.      - conf_win_close
  4805.           controls whether Bingo automatically closes a window when the
  4806.           file is closed.
  4807.  
  4808.      - conf_def_ext
  4809.           allows you to specify the file extensions Bingo will attempt to
  4810.           use when you specify a filename without '.'.  The extensions are
  4811.           checked in order.
  4812.  
  4813.      - conf_video_mode
  4814.           allows you to choose from between three screen handling options:
  4815.                     - autodetect with retrace checking
  4816.                     - autodetect with no retrace checking
  4817.                     - 43 or 50 line mode, if supported
  4818.           Retrace checking will only be in effect if there are only 25
  4819.           lines to be displayed.
  4820.  
  4821.      - conf_cursor
  4822.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4823.  
  4824.      - conf_prn
  4825.           set the printer destination, between the default serial port, the
  4826.           default parallel port, or a file.
  4827.  
  4828.      - conf_tmarg
  4829.           set the top margin, in terms of number of lines.
  4830.  
  4831.      - conf_bmarg
  4832.           set the bottom margin, in terms of number of lines.
  4833.  
  4834.      - conf_lmarg
  4835.           set the left margin which will be used when printing, in terms of
  4836.           spaces.
  4837.  
  4838.      - conf_lines_per
  4839.           set the lines per page, counting the top margin.
  4840.  
  4841.                           Bingo 2.10d Reference Manual
  4842.                                        80
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.      - conf_null
  4849.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4850.  
  4851.      - conf_ctrl_display
  4852.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4853.  
  4854.      - conf_kill_size
  4855.           alters the size of the kill buffer.
  4856.  
  4857.      - conf_cut_stack
  4858.           allows you to choose whether text about to be discarded from the
  4859.           paste buffer should be placed on the stack.  If this is on, this
  4860.           will slow block operations down a bit, but it is a nice safety
  4861.           feature.
  4862.  
  4863.      - conf_auto_cut
  4864.           allows you to toggle how the 'cut' & 'copy' functions respond
  4865.           when no block has been marked.  If auto cut is active, these
  4866.           functions will cut (or copy) the current line.  If auto cut is
  4867.           not active, the current line will be Linemarked.
  4868.  
  4869.      - conf_smart_tabs
  4870.           allows you to specify whether or not "Smart" tabs are active. 
  4871.           Smart tabs cause the 'insert_tab' function to tab over to the
  4872.           same column as the next nonspace character on the line previous. 
  4873.           This changes both the current buffer's setting and the global
  4874.           setting.
  4875.  
  4876.      - conf_matching
  4877.           configures matching mode.  If matching mode is active, entering a
  4878.           '[{<(' character will cause its matching close member to be
  4879.           entered automatically.  This changes both the current buffer's
  4880.           setting and the global setting.
  4881.  
  4882.      - conf_trail
  4883.           allows you to configure whether or not Bingo strips trailing
  4884.           spaces.
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.  
  4899.                           Bingo 2.10d Reference Manual
  4900.                                        81
  4901.  
  4902.  
  4903.  
  4904.  
  4905.      - conf_bounce
  4906.           allows you what cursor movement paradigm Bingo uses.  If Bounce
  4907.           mode is active, Bingo views the entire document as one long
  4908.           string of characters.  Thus, you cannot move off of exiting text. 
  4909.           Further, the cursor will automatically wrap at the end of lines. 
  4910.           If Bounce mode is turned off, cursor movement is by the more
  4911.           traditional method, where you can move any where (horizontally)
  4912.           you wish.
  4913.  
  4914.      - conf_key_bios
  4915.           this governs whether or not Bingo will use the Extended Keyboard
  4916.           Bios if it is found.  On some machines, Bingo may identify it
  4917.           incorrectly, or there may be compatibility problems.  This
  4918.           function allows you to tell Bingo to disregard the extended Bios,
  4919.           even if it is found.  If this is on, the two sets of arrow keys,
  4920.           for example, will be recognized as different.  They will
  4921.           therefore have to be defined separately in your keyboard config
  4922.           file.
  4923.  
  4924.      - conf_erronly
  4925.           allows you to tell Bingo to further restrict valid error lines to
  4926.           those containing the word 'error' (any case).  
  4927.  
  4928.      - conf_mouse
  4929.           controls whether or not Bingo uses a Mouse, if it finds one.
  4930.  
  4931.      - conf_profile
  4932.           controls whether Bingo will check for, and load if found, the
  4933.           profile file of a file's file extension each time a file is
  4934.           loaded.
  4935.  
  4936.      - conf_word
  4937.           allows you to edit the string containing what characters are not
  4938.           part of a word.
  4939.  
  4940.      - conf_scr_save
  4941.           controls whether Bingo will save, and then restore, the DOS
  4942.           screen upon startup and exit.  Will cost you some memory.
  4943.  
  4944.      - conf_name_save
  4945.           controls whether, and how, Bingo saves the last 15 files edited. 
  4946.           You can turn it off, tell it to save the info in the current
  4947.           directory (where Bingo looks first upon startup), or in Bingo's
  4948.           home directory.
  4949.  
  4950.      - conf_delims
  4951.           allows you to input and edit pairs of delimiters for Bingo to
  4952.           balance with the 'match_delim' function.  Both delimiters must be
  4953.           non-blank.
  4954.  
  4955.  
  4956.  
  4957.                           Bingo 2.10d Reference Manual
  4958.                                        82
  4959.  
  4960.  
  4961.  
  4962.  
  4963.      - conf_eol_display
  4964.           allows you to enter the ASCII decimal value of the character to
  4965.           be displayed as the end of line character.  The default is 32,
  4966.           the space character.
  4967.  
  4968.      - conf_exit_to_pick
  4969.           controls Bingo's actions upon exit.  If turned on, Bingo will
  4970.           popup an edit box when you quit the program (except when you exit
  4971.           through the abort_all function).
  4972.  
  4973.      - conf_prn_eol
  4974.           controls whether Bingo terminates lines with a linefeed only or a
  4975.           carraige return/linefeed pair while printing.
  4976.  
  4977.      - conf_prn_lineno
  4978.           sets whether or not Bingo prints line numbers on each line it
  4979.           prints.
  4980.  
  4981.      - conf_prn_header
  4982.           sets whether or not Bingo prints page headers on each page it
  4983.           prints.  Headers consist of the filename, the page number, and
  4984.           the date/time.
  4985.  
  4986.      - conf_timed_backups
  4987.           allows you to specify how often, in terms of changes, to save a
  4988.           backup of a file.  A value of zero (0) indicates no automatic
  4989.           backups are to take place.  The value input becomes the defult
  4990.           value for any subsequently entered files, and becomes the value
  4991.           for the current file; it does not change the value for any
  4992.           existing files.  Any operation which changes the file will
  4993.           increment the change counter.  The current number of changes for
  4994.           each file is displayed on the info screen.  When the
  4995.           predetermined number of changes has occurred, the file is saved
  4996.           as 
  4997.                  backXXXX.bak 
  4998.           where XXXX is the buffer 4 digit id number.  This id number is
  4999.           unique over an editing session, and is displayed as part of the
  5000.           info screen.  The backup files are identical to the files
  5001.           themselves, except that the first line contains the original name
  5002.           of the file (full pathname) and the time of the backup. 
  5003.  
  5004.           *Note*: Be very careful with setting this value.  Generally, a
  5005.           setting between 256 and 1024 is very useful.  However, if you are
  5006.           editing a multi-megabyte file, backups can be a large pain
  5007.           because of the time involved in saving the file.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.                           Bingo 2.10d Reference Manual
  5016.                                        83
  5017.  
  5018.  
  5019.  
  5020.  
  5021.                                 License Agreement
  5022.                                 -----------------
  5023.  
  5024.           This section tells you is how to become a registered user once
  5025.      you decide that you like the program and want to use it on a regular
  5026.      basis.
  5027.  
  5028.           Bingo is distributed under the shareware marketing concept; it is
  5029.      not free software and it has not been released to the public domain.
  5030.      The documentation, executable images, and all other files distributed
  5031.      with Bingo are copyrighted.
  5032.  
  5033.           Shareware is a way of distributing computer software that allows
  5034.      you to try out a program before you purchase it. Programs distributed
  5035.      as shareware typically give you some period of time to use the program
  5036.      and evaluate its usefulness to you. If the program doesn't meet your
  5037.      needs, you're under no obligation to pay for it. If you do find the
  5038.      program useful and wish to continue using it on a regular basis, the
  5039.      shareware program's author usually requests that you pay for the
  5040.      program by sending him or her a completed registration form and
  5041.      payment. This is the approach I have taken in making Bingo available
  5042.      to the public.
  5043.  
  5044.           If you find Bingo to be a useful addition to your software
  5045.      library, you're requested to become a registered user by completing
  5046.      the enclosed registration form and returning it along with the
  5047.      indicated license/registration fee. I hope that you will agree that
  5048.      the $40.00 license fee (for the Single Version registration) or $75.00
  5049.      license fee (for the Lifetime registration) is a small price to pay
  5050.      for the continued use of the program. It requires a large investment
  5051.      to develop, market, and support a product of this complexity. Your
  5052.      support in the form of a license/registration fee will continue to
  5053.      make good software available at low prices.
  5054.  
  5055.           Quantity discounts are available to business, government, and
  5056.      other organizations that wish to use Bingo on multiple computer
  5057.      systems. Bingo is also available at very special rates to
  5058.      organizations who wish to use it for promotional purposes. Write the
  5059.      author for information on using the program this way.
  5060.  
  5061.           You are granted a limited license to use and examine Bingo on a
  5062.      trial basis to determine if Bingo is suitable for your needs. If you
  5063.      find Bingo useful and continue to use it on a regular basis, you
  5064.      should complete and return the registration form along with the
  5065.      indicated license/registration fee.
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.                           Bingo 2.10d Reference Manual
  5074.                                        84
  5075.  
  5076.  
  5077.  
  5078.  
  5079.           You are encouraged to make copies of Bingo for the trial use of
  5080.      other individuals and organizations, subject to the following
  5081.      restrictions:
  5082.           1)   All Bingo distribution files must be copied in unmodified
  5083.                form.
  5084.           2)   You may not include any other files with the distributed
  5085.                copy.
  5086.  
  5087.           You may not distribute Bingo with any other product or
  5088.      service without written permission of the author.
  5089.  
  5090.           Bingo may be included on electronic bulletin board systems for
  5091.      downloading by users of the bulletin board provided the above
  5092.      restrictions are met.
  5093.  
  5094.           Bingo and all accompanying materials are provided "as is" without
  5095.      warranty of any kind. The entire risk of using Bingo is assumed by
  5096.      you.
  5097.  
  5098.           The author, Christopher R. S. Schanck, makes no warranty of any
  5099.      kind, expressed or implied, including but not limited to any
  5100.      warranties of merchantability and fitness for a particular purpose.
  5101.  
  5102.           In no event will the author, Christopher R. S. Schanck, be liable
  5103.      for any damages whatsoever arising out of your use or inability to use
  5104.      the program.
  5105.  
  5106.           If you use Bingo on a regular basis, you should complete the
  5107.      registration form at the end of this document and return it along with
  5108.      the indicated license/registration fee. Registration gives you the
  5109.      right to use the software as documented in the license.
  5110.  
  5111.           A registration fee of $40.00 establishes you as a registered user
  5112.      of the current version of Bingo. 
  5113.  
  5114.           A registration of $75.00 establishes you as a Lifetime
  5115.      registrant, and in this situation you are entitled to the next version
  5116.      of Bingo free.  After that, you will be notified of each subsequent
  5117.      version, and they will be available for a five (5) dollar fee.
  5118.  
  5119.           When you submit your registration fee, unless you specifically
  5120.      request otherwise, the author will mail you a copy of the current
  5121.      version of Bingo and accompanying documentation on disk (3.5" or
  5122.      5.25") for free.  Mailing addresses outside of the continental United
  5123.      States will need to submit a $15.00 shipping and handling charge.
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.                           Bingo 2.10d Reference Manual
  5132.                                        85
  5133.  
  5134.  
  5135.  
  5136.  
  5137.                          Registration Form - Bingo 2.10d
  5138.                          -------------------------------
  5139.  
  5140.      Remit to:            Christopher R.S. Schanck
  5141.                                    PO Box 279
  5142.                                 Hanover MD 21076
  5143.  
  5144.                                    Bingo 2.10d
  5145.  
  5146.      Disk size, circle one: (   3.5"   /   5.25"   / SEND NO DISK )
  5147.  
  5148.  
  5149.      Registration OPTIONS:
  5150.  
  5151.      One-Time Registration ............ _____ @ $ 40.00 each  $ _____
  5152.  
  5153.      Lifetime Registration ............ _____ @ $ 75.00 each  $ _____
  5154.  
  5155.  
  5156.  
  5157.      Bingo printed Documentation ...... _____ @ $ 15.00 each  $ _____
  5158.  
  5159.  
  5160.  
  5161.                                                     Subtotal  $ _____
  5162.  
  5163.  
  5164.      Shipping, Outside the Continental U.S. ......... $ 15.00 $ _____
  5165.  
  5166.                                             Total (U.S.Funds) $ _____
  5167.          
  5168.  
  5169.  
  5170.      Name: __________________________________________________________
  5171.  
  5172.      Company: _______________________________________________________
  5173.  
  5174.      Address: _______________________________________________________
  5175.  
  5176.      ________________________________________________________________
  5177.  
  5178.      ________________________________________________________________
  5179.  
  5180.      Day Phone: _______________________________ 
  5181.  
  5182.      Eve Phone: _______________________________
  5183.  
  5184.  
  5185.                     Prices subject to change without notice.
  5186.  
  5187.  
  5188.  
  5189.                           Bingo 2.10d Reference Manual
  5190.                                        86
  5191.  
  5192.  
  5193.  
  5194.  
  5195.                           Registration Form - Continued
  5196.  
  5197.      I acquired Bingo 2.10d from
  5198.  
  5199.      [ ] - Friend                
  5200.  
  5201.      [ ] - Computer Club
  5202.      Which One? ______________________________________________________
  5203.  
  5204.      [ ] - Electronic BBS        
  5205.      Which One? ______________________________________________________
  5206.      Phone #? ________________________________________________________
  5207.  
  5208.      [ ] - Other
  5209.      Specify: ________________________________________________________
  5210.  
  5211.      I would also appreciate any input you would care to give concerning
  5212.      Bingo. If you have any ideas or comments that would make Bingo a
  5213.      better program, then please let me know.
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.  
  5236.  
  5237.  
  5238.  
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.                           Bingo 2.10d Reference Manual
  5248.                                        87
  5249.  
  5250.  
  5251.  
  5252.  
  5253.                                    The Author
  5254.                                    ----------
  5255.  
  5256.           I received my M.S. in Computer Science from The Ohio State
  5257.      University in March of 1990, and am now employed by a large
  5258.      engineering/manufacturing firm in the Baltimore area.  I was born in a
  5259.      steel town in Eastern Pennsylvania, and attended The Pennsylvania
  5260.      State University as an undergraduate, graduating in May of 1988. I
  5261.      hold a first-degree Black Belt in Tae Kwon Do, and I am an avid reader
  5262.      of science-fiction, fantasy, military fiction, mythology, and just
  5263.      about any other occurance of the printed word.
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.                           Bingo 2.10d Reference Manual
  5306.                                        88
  5307.  
  5308.  
  5309.  
  5310.  
  5311.                                 Acknowledgements
  5312.                                 ----------------
  5313.  
  5314.           There are many I must acknowledge for the inspiration for writing
  5315.      this program: family, friends, colleagues. In addition, I want to
  5316.      thank Borland for their excellent Turbo C compiler, which I used to
  5317.      write Bingo; IBM for making my beloved baby, lo those many years ago;
  5318.      and all the other folks who wrote software I used to create Bingo. 
  5319.      Thanks to all my computer science professors, who instilled the
  5320.      knowledge to write such an application in me, often against my will. 
  5321.      I also thank the members of the Columbus Computer Society (CCS),
  5322.      particularly the members of the Programmer's SIG, several of whom
  5323.      served as Beta test people during versions 1.0 to 2.0, putting their
  5324.      programs In Harm's Way as they tested features.
  5325.           Thanks to the folks at Home Box Office for running an endless
  5326.      amount of truly bad movies at all hours of the night to keep me
  5327.      company on some of the more involved programming adventures.  
  5328.           And mucho thanks to my premier beta-tester, Bob Boyken, who was
  5329.      also the first registrant of version 1.1a.  Bob provided me with much
  5330.      needed time, effort, and ideas, not to mention a help file.  His
  5331.      efforts, both in using Bingo regularly, and in testing things for me
  5332.      on particular hardware combinations, was nothing short of awesome.
  5333.           Additional thanks to Rich Thompson, for looking at the earliest
  5334.      virtual-memory version of 2.10 and not cringing.  Or at least not
  5335.      cringing too much.
  5336.           Thanks to Beaker, Ernie, Cookie, and the rest of the Muppets for
  5337.      frequent sanity checks.
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.                           Bingo 2.10d Reference Manual
  5364.                                        89
  5365.  
  5366.  
  5367.  
  5368.  
  5369.                                       Index
  5370.                                       -----
  5371.  
  5372.      abort . . . . . . . . . . . . . . . . . . . 17, 18, 35, 45, 59, 60, 83
  5373.      abort_all . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60, 83
  5374.      again . . . . . . . . . . .  6, 16, 22, 28, 33, 41, 46, 47, 50, 61, 74
  5375.      align . . . . . . . . . . . . . . . . . . . . . . . . . . .  2, 43, 69
  5376.      ascii_table . . . . . . . . . . . . . . . . . . . . . . . . 32, 45, 70
  5377.      author  . . . . . . . . . . . . . . . . . . . . . . . . 49, 84, 85, 88
  5378.      back_space  . . . . . . . . . . . . . . . . . . . . . . . . . . 57, 58
  5379.      back_tab  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5380.      backup_all  . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 60
  5381.      backup_file . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 60
  5382.      begin_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5383.      begin_of_text   . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5384.      block_copy  . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 66
  5385.      block_delete  . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5386.      block_load  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
  5387.      block_move  . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 66
  5388.      block_save  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
  5389.      bot_of_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5390.      bottom_of_block . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5391.      bottom_of_screen  . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5392.      buffer_info . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5393.      carriage  . . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 57
  5394.      center_line . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5395.      center_text   . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5396.      chdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5397.      choose_file . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 59
  5398.      clean_all   . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5399.      clean_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5400.      compuserve  . . . . . . . . . . . . . . . . . . . . . . . . .  5, 8, 9
  5401.      conf_auto_cut . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5402.      conf_autoindent . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5403.      conf_backspace  . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5404.      conf_backups  . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5405.      conf_bmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5406.      conf_bounce . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5407.      conf_button_wait  . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5408.      conf_cmode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5409.      conf_color  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5410.      conf_ctrl_display . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5411.      conf_cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5412.      conf_cut_stack  . . . . . . . . . . . . . . . . . . . . . . . . 54, 81
  5413.      conf_def_ext  . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5414.      conf_delims   . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5415.      conf_eof  . . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 78
  5416.      conf_eol_display  . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5417.      conf_erronly  . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5418.      conf_exit_to_pick   . . . . . . . . . . . . . . . . . . . . . . . . 83
  5419.      conf_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5420.  
  5421.                           Bingo 2.10d Reference Manual
  5422.                                        90
  5423.  
  5424.  
  5425.  
  5426.  
  5427.      conf_key_bios . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5428.      conf_kill_size  . . . . . . . . . . . . . . . . . . . . . . . . 54, 81
  5429.      conf_lfs  . . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 78
  5430.      conf_lines_per  . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5431.      conf_lmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5432.      conf_macro_death  . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5433.      conf_matching . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5434.      conf_mdelay . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 80
  5435.      conf_mouse  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5436.      conf_name_save  . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5437.      conf_null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5438.      conf_prn  . . . . . . . . . . . . . . . . . . . . . . . . . . . 80, 83
  5439.      conf_prn_eol  . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5440.      conf_prn_header   . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5441.      conf_prn_lineno   . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5442.      conf_profile  . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5443.      conf_rmargin  . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5444.      conf_scr_save   . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5445.      conf_search . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5446.      conf_shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5447.      conf_smart_tabs . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5448.      conf_sound  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5449.      conf_stripping  . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5450.      conf_tabexpand  . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5451.      conf_tabsize  . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5452.      conf_timed_backups  . . . . . . . . . . . . . . . . . . . . . . 36, 83
  5453.      conf_tmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5454.      conf_trail  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5455.      conf_video_mode . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5456.      conf_word   . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5457.      conf_wordwrap . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5458.      copy  . . . . . . . . 4, 9, 11, 35, 41, 42, 54, 60, 66, 67, 71, 81, 85
  5459.      copy_append . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
  5460.      cur_file  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
  5461.      cursor_down . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 63
  5462.      cursor_left . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5463.      cursor_right  . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5464.      cursor_up . . . . . . . . . . . . . . . . . . . . . . . . . . . 46, 63
  5465.      cut . . . . . . . . . . . . . . . . . . . . 41, 42, 54, 58, 66, 67, 81
  5466.      cut_append  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
  5467.      default_bspace  . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5468.      default_del . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5469.      define_scrap  . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5470.      del_bol . . . . . . . . . . . . . . . . . . . . . . . . . . 33, 54, 58
  5471.      del_char  . . . . . . . . . . . . . . . . . . . . . . . . . . . 57, 58
  5472.      del_eol . . . . . . . . . . . . . . . . . . . . . . . . . . 33, 54, 58
  5473.      del_line  . . . . . . . . . . . . . . . . . . . . . . . . . 33, 54, 58
  5474.      del_word_lt   . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5475.      del_word_rt   . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5476.      delete_file . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5477.      detab . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 43, 68
  5478.  
  5479.                           Bingo 2.10d Reference Manual
  5480.                                        91
  5481.  
  5482.  
  5483.  
  5484.  
  5485.      display_file  . . . . . . . . . . . . . . . . . . . . . . . . . 46, 71
  5486.      down_page . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 63
  5487.      dup_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5488.      edit_file . . . . . . . . . . . . . . . . . . . 34, 35, 51, 53, 59, 74
  5489.      end_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5490.      end_macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5491.      entab . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 43, 68
  5492.      exec_command  . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5493.      extend_mark . . . . . . . . . . . . . . . . . . . . . . . . . . 41, 66
  5494.      fcase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5495.      file  . 1-3, 6, 10-14, 17, 19-22, 24-27, 29, 30, 34-37, 40, 41, 43-46,
  5496.                    50-54, 57, 59, 60-64, 66-68, 70, 71, 73, 74, 76, 77, 80,
  5497.                                                                  82, 83, 89
  5498.      file_all  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
  5499.      fill_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5500.      global  . . . . . . . . . . . . . . . . . . . . 45, 62, 70, 78, 79, 81
  5501.      help  . . . . . . . 1, 2, 7, 11, 18, 29, 31, 38, 44, 46, 55, 69-71, 89
  5502.      indent_down . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5503.      indent_up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5504.      info  . . . . . . . . . . .  4, 18, 31, 42, 44, 47, 67, 70, 71, 82, 83
  5505.      insert_tab  . . . . . . . . . . . . . . . . . . . . . . . . . . 57, 81
  5506.      jump  . . . . . . . . . . . . . . . . . . . . . . . . . 40, 53, 63, 64
  5507.      jump_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5508.      key_set_impress . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5509.      key_set_load  . . . . . . . . . . . . . . . . . . . . . . . . . 22, 73
  5510.      key_set_save  . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5511.      last_error  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
  5512.      lcase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5513.      leap_backward   . . . . . . . . . . . . . . . . . . . . . . . . . . 62
  5514.      leap_forward  . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
  5515.      license . . . . . . . . . . . . . . . . . . . . . . . . . .  4, 84, 85
  5516.      line_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5517.      load_file . . . . . . . . . . . . . . . . . . . . . 25, 26, 34, 51, 59
  5518.      load_profile  . . . . . . . . . . . . . . . . . . . . . . . . . 45, 70
  5519.      look_buffer . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5520.      macro . 1, 2, 6, 12, 21, 24-26, 29, 37, 38, 45, 49, 50, 53, 62, 73, 79
  5521.      main_menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 16, 57
  5522.      mark_last_found   . . . . . . . . . . . . . . . . . . . . . . . . . 62
  5523.      match_delim . . . . . . . . . . . . . . . . . . . . . . . . . . 69, 82
  5524.      modify_save . . . . . . . . . . . . . . . . . . . . . . 25, 35, 59, 60
  5525.      modify_save_all . . . . . . . . . . . . . . . . . . . . . . 25, 35, 60
  5526.      mouse_scroll  . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5527.      name_buffer . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5528.      next_error  . . . . . . . . . . . . . . . . . . . . . . . . 25, 53, 77
  5529.      next_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5530.      next_word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5531.      onekey_def  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5532.      open_end  . . . . . . . . . . . . . . . . . . . . . . . . . . . 25, 26
  5533.      paste . . . . . . . . . . . . . 17, 41, 42, 47, 54, 55, 66, 67, 77, 81
  5534.      paste_kill  . . . . . . . . . . . . . . . . . . . . . . . . . . 55, 77
  5535.      paste_replace . . . . . . . . . . . . . . . . . . . . . . . . . 41, 66
  5536.  
  5537.                           Bingo 2.10d Reference Manual
  5538.                                        92
  5539.  
  5540.  
  5541.  
  5542.  
  5543.      pick_exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5544.      pick_file   . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  5545.      place_mark  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5546.      point_mark  . . . . . . . . . . . . . . . . . . . . . . . . . . 29, 66
  5547.      prev_error  . . . . . . . . . . . . . . . . . . . . . . . . . . 53, 77
  5548.      prev_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5549.      prev_word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5550.      print_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 52, 76
  5551.      query_quote . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5552.      quit  . . . . . . . . . . . . . . . . . 17, 34, 35, 44, 59, 62, 70, 83
  5553.      quit_all  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 59
  5554.      quit_and_save_status  . . . . . . . . . . . . . . . . . . . . . . . 70
  5555.      reform_para . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5556.      register  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  5557.      rename_file . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 59
  5558.      repeat  . . . . . . . . . . . . . . . . . . . 1, 2, 46, 49, 61, 69, 71
  5559.      repeat_last   . . . . . . . . . . . . . . . . . . . . . . . . . 46, 71
  5560.      replace . . . . . . . . . . . 1, 2, 24, 37, 39, 41, 45, 61, 62, 66, 78
  5561.      report_bsize  . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5562.      restore_line  . . . . . . . . . . . . . . . . . . . . . . . . . 54, 77
  5563.      rotate_kill . . . . . . . . . . . . . . . . . . . . . . . . . . 55, 77
  5564.      run_macro_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5565.      save_all  . . . . . . . . . . . . . . . . . . . . . . . . . 25, 35, 60
  5566.      save_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5567.      save_settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5568.      scrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49, 73
  5569.      scroll_down . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5570.      scroll_left   . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5571.      scroll_right  . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5572.      scroll_up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5573.      search  . . . . . . . . 1, 2, 19, 24-26, 37-39, 45, 49, 61, 62, 69, 78
  5574.      search_macro  . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
  5575.      send_ff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
  5576.      send_lf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
  5577.      send_sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
  5578.      setup_err_parse . . . . . . . . . . . . . . . . . . . . . . 25, 53, 77
  5579.      shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5580.      shift_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5581.      show_marks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5582.      single_key_load . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5583.      single_key_save . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5584.      snap_to_mouse_xy  . . . . . . . . . . . . . . . . . . . . . . . 29, 64
  5585.      sort_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5586.      strip_highbit . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5587.      support . . . . . . . . . . . . . . . . 1, 2, 4, 7, 15, 31, 37, 49, 84
  5588.      swap_buf_and_block  . . . . . . . . . . . . . . . . . . . . . . . . 67
  5589.      swap_execute  . . . . . . . . . . . . . . . . . . . . . . . 25, 47, 72
  5590.      swap_shell  . . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5591.      switch_file . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 59
  5592.      time_stamp  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5593.      toggle_autoindent . . . . . . . . . . . . . . . . . . . . . . . . . 57
  5594.  
  5595.                           Bingo 2.10d Reference Manual
  5596.                                        93
  5597.  
  5598.  
  5599.  
  5600.  
  5601.      toggle_cmode  . . . . . . . . . . . . . . . . . . . . . . . . . 56, 57
  5602.      toggle_display  . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5603.      toggle_ins  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
  5604.      toggle_wrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
  5605.      top_of_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5606.      top_of_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5607.      top_of_screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5608.      twokey_def  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5609.      ucase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5610.      undefine_key  . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
  5611.      unkill  . . . . . . . . . . . . . . . . . . . . . . . . . . 33, 55, 77
  5612.      unmark  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62, 66
  5613.      up_page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5614.      version_info  . . . . . . . . . . . . . . . . . . . . . . . . .  4, 71
  5615.      vertical_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5616.      virtual memory  . . . . . . . . . . . . . . . . . . . . . 1, 6, 13, 14
  5617.      window_bottom . . . . . . . . . . . . . . . . . . . . . . . . . 25, 74
  5618.      window_close  . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5619.      window_edit . . . . . . . . . . . . . . . . . . . . . . . . . . 51, 74
  5620.      window_load . . . . . . . . . . . . . . . . . . . . . . . . . . 51, 74
  5621.      window_next . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5622.      window_one  . . . . . . . . . . . . . . . . . . . . . . . . 25, 51, 74
  5623.      window_previous . . . . . . . . . . . . . . . . . . . . . . . . 25, 74
  5624.      window_resize . . . . . . . . . . . . . . . . . . . . . . . 25, 51, 75
  5625.      window_split  . . . . . . . . . . . . . . . . . . . . . . . 25, 51, 74
  5626.      window_top  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5627.      window_vertical . . . . . . . . . . . . . . . . . . . . . . . . 51, 74
  5628.      window_zoom . . . . . . . . . . . . . . . . . . . . . . . . . . 51, 74
  5629.      word_count  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5630.      write_profile . . . . . . . . . . . . . . . . . . . . . . . . . 45, 71
  5631.      zap_file  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.                           Bingo 2.10d Reference Manual
  5654.                                        94
  5655.  
  5656.